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PREFACE 


This document explains the philosophy and structure of the PDP-11 
Disk Operating System (DOS) Monitor. It is written for the 
PDP-11 programmer who needs to know the internal operation of 
the Monitor in more detail than is given in the PDP-11 Disk 
Operating System Monitor Programmer's Handbook (order no. DEC- 
11-MWDC-D), which is intended for the general user. Thus, this 
document should be of assistance toi 

• Users who wish to adapt or extend the Monitor for their 
own special applications. 

• Software Support Specialists. 

• Programmers responsible for DOS Monitor maintenance or 
modification. 

The document assumes familiarity with the contents of the 
Programmer's Handbook, and also with the DOS system programs as 
described in the documents listed on the back of the front page. 

The source listings of the Monitor (available from DEC'S Software 
Distribution Center) would be useful since this document is de- 
signed merely to supplement the detailed comments included in 
the source listings. 

The document is divided into nine chapters! 

Cha p ter 1 provides an overview of the concepts and organi- 
zation of the DOS Monitor and gives general information on 
the form of the rest of the document. 

Chapter 2 is devoted to the central executive section of 
the Monitor which is always resident in core memory. 

Chapt er 3 discusses the overall philosophy for the handling 
of I/O from any peripheral device, followed by a detailed 
examination of the routines providing program I/O services. 
This chapter also contains an introduction to device drivers. 

Chapter 4 is particularly concerned with I/O upon bulk- 
storage devices for which a file-structure is defined. A 
general description of this structure is given, followed by 
an explanation of each of the special routines for file 
management. 

Chapter 5 describes the modules which provide I/O services 
to load and unload the Monitor and certain general utilities. 

Chapter 6 describes the methods adopted for the handling of 
operator commands at the console keyboard and the processing 
of each command. Also included is a discussion of a transient 



Monitor section which occupies memory in the absence of a 
user program. 

Chapter 7 covers the question of error diagnosis and out 
lines the routine providing a central printing service for 
messages from both the Monitor itself and the DOS system 
programs. 

Chapter 8 shows how the Monitor is initially built and 
stored ready for use and can be later extended or modified 

Chapter 9 explains the format and contents of various 
system object and load modules. 

Each chapter is concluded with its referenced illustrations. 


NOTE 

Appendix A, frequently referenced herein, was not 
available for this printing, thus it does not 
appear. In June 1972, the appendix will be avail- 
able on request (free) from DEC'S Software Distri- 
bution Center, Maynard, Mass. 01754. 



SOFTWARE SUPPORT CATEGORIES 


Digital Equipment Corporation (DEC) makes available four categories of software . These 
categories reflect the types of support a customer may expect from DEC for a specified software 
product. DEC reserves the right to change the category of a software product at any time. 

The four categories are as follows: 


CATEGORY I 

Software Products Supported at no Charge 

This classification includes current versions of monitors, programming languages, and 
support programs provided by DEC. DEC will provide installation (when applicable), advisory, 
and remedial support at no charge. These services are limited to original purchasers of DEC 
computer systems who have the requisite DEC equipment and software products. 

At the option of DEC, a software product may be recategorized from Category I to 
Category II for a particular customer if the software product has been modified by the customer 
or a third party . 


CATEGORY II 

Software Products that Receive Support for a Fee 

This category includes prior versions of Category I programs and all other programs avail- 
able from DEC for which support is given. Programming assistance (additional support), as 
available, will be provided on these DEC programs and non-DEC programs when used in con- 
junction with these DEC programs and equipment supplied by DEC . 


CATEGORY III 
Pre-Release Software 

DEC may elect to release certain software products to customers in order to facilitate 
final testing and/or customer familiarization. In this event, DEC will limit the use of such 
pre-release software to internal, non-competitive applications. Category III software is only 
supported by DEC where this support is consistent with evaluation of the software product. 
While DEC will be grateful for the reporting of any criticism and suggestions pertaining to a 
pre-release, there exists no commitment to respond to these reports. 


CATEGORY IV 
Non-Supported Software 

This category includes all programs for which no support is given,. 
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INTRODUCTION 


like other bulk media# aeneral lv» a disk is convenient for 
the storage and retrieval of svstem software such aa Edi- 
tors# Apsembl era# Compilers* etc.! which assist the.eomouter 
user towards a more rapid development of h 1 a sppI i cat 1 or 1 a 
programs and thereafter of those oroprars themselves and 
their data. More significantly# beeauae of Ita relatively 
fpat random aeeeaa eaoab 1 1 1 t 1 es * a disk can be treated as a 
vi rtuel extension of available core memory# thereby enabling 
the provision of a wide ranae of run-time services which can 
ease .the. burden of ell proorama* even in the smeller eonfl- 
gurat 1 ons. 

The PDP-11 Disk Ooeretlng System (DOS) is designed .to take 
advantage of these benefits in the single- uaerdisk-based 
environment. Thuf it consists basleallv of e Monitor which 
supplies the services mentioned and In particular supports a 
eomorehensive set of eroorem deveiooment software. In the 
Programmer's Handbook (DEC-1 1-MWDC-B) the Monitor la des- 
cribed for the user who wishes merely to obtain Its services 
for his own Durooses and to, control the operation of his 
ovate*. The usage of Its associated orograms, listed below, 
Is explained in the relevant Programming Manual shown! 


EDIT-11 Text Editor 
PAL-UP Assembler 

LINK-11 Linker. & LIBP-11 Librarian 

0DT-11P Debuogin Aid 

PIP-11 File Utilities Package 
FOPTPAN FOPTPAN IV Comoller 


0EC-11-EEDA-D 
DEC-1 1-A3DC-D 
DEC-1 1-ZLDC-D 
DEC-1 1-00DA-D 
DEC-1 1-PIDB-D 
DEC-1 1-KFD8-D 


This manual supolements the information In the M en1tor Pro- 
grammer's Handbook bv oresentlng a more detailed discussion 
of the facilities provided by the Monitor and the methods 
used _te achieve these. In general* the baekaround concents 
of eeeh, of i ts asoeets are eonsi dered f o! 1 owed by am indivi- 
dual examination of the routines satisfying those concepts. 
The procedures by whleh the. Monitor Is preoared for usage 
ere also illustrated to, ajsjat those who need to deyeloo Its 
amenities further, by modification* addition# or extension. 
As far as possible the. manual is arranged to enable Immedi- 
ate reference to a particular teolei this then contains po- 
inters to supporting Information, This also should allow 
revisions to be readily Included by replacement of the ap- 
propriate section. 


The purpose. of this Chaeter especially is to orovide a gen- 
eral .overvjew ©f .the, Monitor, 9eetion 1,1 discusses Its 
principal ajms and its organization to meet these alms Is 
described in Section 1.2. Section 1.3 then introduces some 
established conventions. 
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1,1 The Function of the QOS Monitor 


The DHS Monitor twists for two main ra esonat 

a. To make available to a running program a, whole aer- 
ies of general utility routines to aimelifv its us- 
age of the PDP-11 as a system# in ©articular for 
the handling of its I/P reou i r ement a , 

b. To, enable the user at the console keyboard to main- 
tain control of the ooerationa of his system. 

As noted# the principal area of service to a orogram eon- 
earns I/O management, Chapter 3 will shew that the user is 
given the opportunity to raouaat as mueh or as little assis- 
tance as Ha needs. In many eases Ha need not consider the 
devices He will aetuallv use when tHe orooram is under axe- 
eution. If He wishes to utilize the facilities offered by 
bulk madia for the stqrggf of many independent seta of data 
or to share these facilities with other users, he Is able to 
effect this within the framework of a Moni tor-cont rol 1 ed 
file structure to be discussed in Chapter 4, 

j/0 aside, a runnina proaram may often need information 
about the particular system in which it. la currently workina 
or mev reauire general help in manipulating its data. 
Moreover the processes by which it is loaded and. unloaded 
are essential services. Chapter 5 covers the Drovision of 
these a n d other services. 

In the normal way, the console operator needs to be able to 
dictate the sequence in whieh programs are executed and to 
eeeasa fhem accordingly. On occasion# he may be obliged to 
euoolv intermediate aet-uo information. Moreover it is pos- 
sible# even. in the best regulated svatem# that he must in- 
tfrvene.to interrupt the normal seauenea when adverse condi- 
tions arise* The method by whieh he can ewergise these con- 
trols from the keyboard at all times is described in Chapter 
6# and Chapter 7 shows how he may be keot informed of those 
adverse conditions. 


1*2 Monitor Oroanlzetlen 


Tfc>s major feature of the Monitor's streteoy to neat its com- 
mitments aa outlined In the previous section Is the fact 
that It has bean setuo as a aeries of normally Independent 
modules* each of which satisfies one eoeelfle function. 
This modularity has the following advanteoesi 

1. Ease of developmant 

2. Flexibility in usage 

3. Extensibility 

The first of these implies that the Monitor has been brought 
to Ita. eurrant state bv preparing eaeh module separately, 
ineluding any necessary modification (endln some. eases com- 
plete replacement) and check-out. before finally incorporat- 
ing It Into tha svstem. The third advantage effectively sa- 
ys the fame thing for future development, either as a gener- 
al erevlsipn or to meet a.soee 1 f 1 c usar ' s requirements (pro- 
vided of eourse he himself does this). 

The matter of flexibility Is particularly relevant because 
it ie this fsoeet whieh. really Permits the Monitor to gain 
most benefit from the availability of the disk within the 
svstem. as netod In the introduction to this chaster. 
Basically certain. modul as. which are discussed in Chaoter 2. 
must remain within tha eomouter memory at all times because 
they control the system generally, .Figure 1-1 illustrates 
their normal location. The remaining modules which Perform 
eohemerfl tasks nead only reside upon the disk which sup- 
ports the svstem (called elsewhere the "svstem device") If 
the available eomouter memory Is too limited. They esn then 
be loaded when required and ean later be removed when their 
purpose has been served. To this end. a Library area is 
reserve^ uoon the aystemdevlce as shown in Figure J-2, Its 
format Is designed to allow simple set-up (see Section 8.2) 
and ready aecess (see Sections 2,1,2 and 2.1.4). 

However, despite the faet that sueh loading can be accom- 
plished fairly quickly from the disk, it still takes finite 
time and the user who has memory to. scare may prefer to avo- 
id the wastage. Modularity again helos, as follows (see 
Figure 13)» 

a. If a particular module Is reaulred so frequent- 
ly bv all users of a svstem. It ean be added to 
those already included. In the permanently resi- 
dent oart of the. Monitor at system generation 
(currently bv llnkino - see Section *,1,2) 
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b. A module whleh is particularly appropriate to 
on® iddI i e®t 4 on. ean be loaded with the Program 
concerned )uat for the duration of a run. The 
user in this ease Indicates his requirement as 
a alobal reference In the program (see Pro- 
grammer's Handbook for details) and# as shown 
in Section 5.1* the Program loader obliges If 
the module Is not already permanently resident. 
(No linking oeeurs# henee the same program can 
be run ef f pet lyal v. 1 n anv system If the overall 
eore capacity permits). 

Thus modular flexibllty gives the usee the eholee between 
residency of swapping from the disk. In the latter ease* It 
ahould be noted* the temporarily loaded routine oeeuoles a 
reserved area within the Monitor (see Section 2,3,1) • It 
does not require that part of a program be swaoped out 
fjrst. This avoids two accesses. and means, that no restric- 
tions need be plaeed upon the.aetivitles of a program as 
might h* the ease If part of ita area were potentially re- 
movable. 

A. second feature of the Monitor la dvnamie buffer alloca- 
tion# whieh Is most elosely related to the I/O operations as 
diseussed In Chaotar 3. It wjll be shown that until a run- 
ning preorjsm actually reouires I/O services# no memory Is 
allocated for the purpose but thereafter appropriate buffers 
are dynamically set-up or released from the then free soaee 
(sea Section 2,4,2). Henee# the run-time eore image Is as 
illustrated in figure 1-4, (A similar layout Is also In- 
cluded In the_Programmer • s Handbook.) In this resoeet# some 
of .these buffers may be used to load the rlrivers for the 
devjees providing I/O. These are stored within the system* 
deviee Library with other modules. Unlike the latter# 
however* the drivers eannot be leaded for the duration of a 
program, for .reasons given In Seetion 2,1,3, nevertheless# 
they mav be linked into the permanently resident Monitor, as 
above. 


1.3 M omltor C onvent 1 one 


The Monitor's modularity imposes a need, for certain conven- 
tions, In order to permit the neeessarv Interface between Its 
various components and the user program. This Section des- 
cribes the more common ones. 
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1. 3 .1 _ Cal 1 ino Monitor Modules 

Both ft the user level and internally within the Monitor# 
the, standard method bv whieh a Monitor module ie accessed ia 
through, the EMT instruction (1). This hat been choaen be- 
cause its lower bvte ia not eonaidered in the hardware de- 
coding operation! it can therefore be used for a software 
eode to identify the module reauired end avoids the use of a 
second word# e.g,# (as shown in the Programmer's Handbook) a 
call for an I/O .READ is EMT 4 (or 1040&4), It also ensures 
that the necessary handler for this instruction has the op- 
portunity to control all communication paths, throughout the 
avetem#,a particular advantage in the sweeping situation, 
^enee. Figure 1»S illustrates the Monitor structure with this 
in mind. 

In many eases* tha eall to a module reouires a .subsidiary 
transmission of data., At the user level* this is effected 
(as described in the Programmer's Handbook) bv means of the 
processor staek in order to allow the prooram complete free- 
dom in its use of registers. However* to keep the number of 
essential. Pushes to a minimum one of the arguments may be a 
pointer to a list of additional items. (This oraetiee may 
mean that the user need exercise some caution if programming 
"re-entrant 1 v" sinee anv such list must.be impure unless it 
also ip developed on the stack). Inside the Monitor# data 
may be passed. eithar on the staek or in registers. The mo- 
dule de?en iet.iena in the following chapters show the expect- 
ed eallino Process, 


1.3 .2 Petum State 

The ganeral principle applied is that unless data is being \ 
returned the Processor staek is.eleered of the neeesaarv I 
items. pushed by the call. If data is returned# it is then I 
the responsibility of the calling routine* be it the user 
program or another Monitor module# to remove sueh data as 
soon as it has served its purpose. The register state must 
rempin as on entry. (Internally# this may not apelv if the 
Registers are aoain used to return data I this is also indi- 


1. The two principal exceptions to this General rule are! 

a. Peouests for device driver services (see Section 
3.3), 

b. Cells for Error Diagnostic Print (see Chapter 7) 
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1,3,3 Naming Convention! 

For seareh access to the Internal modules, the following 
conventions for names have been edootedt 

1, Potentially swapoable proeeseine routines • for 
thesp# three alphanumeric characters which can be 
radix 50 peeked Into one word, (see Peetien 5,3) 
Thfy are used both as Assembler ,TITLF designation 
for Library searching (see Section 8,2,1) and as 
global reference for linking (see Section 8,1,2), 
As, noted In the Prggrammer'e Handbook# users should 
avoid these names In their own globals. 

2, Pevleea ere normally Identified bv a two letter 
ee^e# as listed In the Programmer's Handbook, A 
third letter may be added to distinguish between 
different controllers for the same devlee e.g, OTA 
end 0TB might identify two TCll's, The eede may be 
followed by an octal bvte value to specify a oar* 
tieular unit. 


J_, 3. 4 Oaf i n I t I ons 

The Proorammer's Handbook contains a list of the commonly 
used tgrma end a eomprehensi ve glossary. This manual com- 
piles with that terminology, 

Xn the flguref whleh eonelude this document, entire core Is 
Illustrated with word 0 at the bottom end uooer words at the 
topt whereas# words In tables ere Illustrated with the smal- 
lest word at the too. 
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CHAPTER 2 

RESIDENT MONITOR 


15 was show'"' in. Chanter 1 that# 1 n qenerel# the user ean 
hlmaelf determine the way 1m whieh he will use the modules 
forn1ng_the DOS Monitor either to save time bv having them 
resident in memory or to save core by leaving them to be 
brought. frgn the system-device only when required. However 
for certain of the modules there Is n© choice! they must be 
resident at all times for one of the following reasons! 

a. They. control the system qe.nerallv Including the 
loading of other Monitor routines from the ays- 
tem-devlee. 

b. They are ealled with sufficient freauenev that 
to bring tham from the system devlee every time 
they are needed would be unrealistic. 

The purpose of this ehaeter is to dlaeusa the principal mo- 
dules In thla eataflorv. Section 2,1 contains descriptions 
of the tables used bv the Monitor to maintain sdeouate con- 
trol of the system and shows how thev are set up Initially, 
Section 2.2 Is concerned with the real heart of the. Monitor* 
the EMj handler# §nd Section 2,3 looks at the techniques for 
bringing modules from t ha .svst em-dev 1 ce by the Swao Area 
Manager. Some general -ouroose subroutines are egvered In 
section 2.4 and finally Section 2.5 outlines the clock con- 
trol routine. 

Two other resident modules are 1 nt ent 1 one 1 1 v omitted here In 
order that they may be discussed In context! 

1, The system-device driver - see Section 3,3. 

2. The minimal console typewriter driver needed to 
service keyboard command Inputs - see Section 6,1, 

Presently the ,PEAD/. WRITE processor must also be resident, 
bv reason of Its size, It eannot be brought into the Swao 
Buffer <n the usual manner. Nevertheless It Is described 
with the other I/O processors In Section 3,2, 

The layout of the modules within the permanently resident 
Monitor area is Illustrated In figure 2-1. 
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2*1 Monitor Table* 


The object of this Section is to introduce the various 
tablas which ara set uo within the reaident M enit©r area# 
for Intercommunication between all Monitor routine*# Th* 
tablaa ( tham*e1vas are final discussed. This is followed by 
a description of the initial laratfon process whieh is mainly 
provided te ensure that th* table* are eorreetly aet-uo for 
use when the Monitor is loaded. 

It fhould be noted at thia ooint that th* Monitor h*s been 
dasionari to be independent of the oosition it occupies in 
mamprv. This mean* that only thofe routines which form the 
bftie resident Monitor ean reference eaeh other directly 
ajnee the appropriate connection* can be established during 
linltaa* by LINK-11, Ail other routine* whiehcan potential- 
ly b* awaoped-in only when reouired must use indirect m*th« 
ods. 

To provide the moat st rai oht forward access to freauentlv re- 
ouirad areas in th* residgnt Monitor# DOS therefore utilises 
the veetor space in location* 40-37# aenerallv reserved in 
all PDP-11 system* for system software use, These an* in 
fact the onl y , 1 ocat i on* addressed absolutely within the Mon- 
itorCl) (deviee driver* controlling th* external oaae of 
coura* exeeoted), Fioure 2-1 show* th*ir present usage. In 
general, a, reference through them retires a level of indi- 
rection beyond that provided within the format of a single 
PDP-IJ instruction, H*nee the common techniaue for entry# 
say# into_a general purpose, subrout i na wi th its atart-ooint 
in one of th* vectors ie via the top of the processor stack 
aa i 


MOV f#44,-(SP) 
JSR PC# • (SP) + 


I GET START ADDRESS OF 
fSUBP, 1 S , RS A V 1 
I ENTER ROUTINE & CLEAR STACK 


2,1.1 System Vector Table (RMQNj ) 

Th* System Veetor Table CSVT) provides a eommon area for the 
storage of information on th* atate of the system at anv 
time, Tn particular# it contains pointers to other parts of 


1, Th* file structure routines currently assume the System 
Vector Jable CSVT? starts at absolute location 400, This is 
a restriction that will be fixed in later releases of DOS, 
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the resident Monitor whieh or* not referenced freouentlv 
enough to warrant the more Immediate aeeese discussed above 
or to areas, within a running user program, It dees not In- 
elude detail for other routines which normally exist only 
within the Monitor Library stored on the evstem-dev 1 ce. 
These are covered bv separate tables which will be dlseussed 
In the following sections. 

The table occupies the first eart of the resident Monitor 
area (the only rpal reason for this being the feet that its 
souree al so. contains the contents of the fixed vectors in 
40*57) . Normally It starts Immediately above the reserved 
Interrupt veetor specs at loeetion 400, Nevertheless# sines 
It Is .always rsfersneed through location 4a# this address 
can be ehanoed by reesaemblv# particularly if an installs* 
tjon needs extra vectors for special devices (because of the 
file structures 1 restriction indicated above# the SVT ad- 
dress of V004A version of DOS must not be changed) (1). 

The Itefs currently In the SVT are listed In flours 2*2. In 
the nain# theea are eel f-exel anatorvf however additional 
notes have bean Included where neeesearv. The table ean be 
expanded as raouired bv the current state of Monitor devel- 
opment but only bv addition at the end. The presently de- 
fined Internal structure eannot be changed slnee all Monitor 
routines dpoend uoon fixed relative positions within the SVT 
In order to reference Its content. 

The SVT. is basleallv established when the resident Monitor 
is first linked throughout LINK-il as described In Section 
8*1.2. The table souree has been set uo to Include# In par- 
ticular# the naeeaaarv global references to other Monitor 
addresses to accomplish this. Other table entries whleh re- 
flect. the constant state of the. configuration In use are set 
up during the Initial iiation process whieh follows Monitor 
loading (sea. Section 2,1.4). The variable entries# ther- 
eafter# are filled in or removed appropriately by several 
Monitor, routines and these will be noted at the relevant Po- 
int throughout the remainder of this Manual. In order that 
the user program may also reference particular entries 
deemed desirable# the General Utilities request bpsed on EMT 
41 is provided as the recommended means (see Section 5,2) 


1. This facility may also allow a user who wishes to res- 
erve an area of memory outside Monitor control to do so. 
However this usage Is not considered a normal DnS provision. 
Thus correct Monitor operation is not guaranteed if Its bot- 
tom Is forced above 16K# the point at which eesltlve ad- 
dresses beeome negative. 
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2.1.2 Monitor Residency Table (R mqni ) 

The Monitor Reeldeney Table (MRT) tupoMes two types of In- 
formation, mainly fop the EMj handler (see Section 2,2)t 

1. It shows which Monitor routines are resident In 
memory, either permanently on for the duration of a 
orogram run, and where thev are loaded currently. 

2. It. acts aa a directory to the remaining routines as 
stored within the Monitor Library on the 
system-device, to enable immediate aeeess when one 
of_ these routines must be brought into e Swsd 
Buffer. 

The table la a set of one-word entries, eaeh eorresoondl no 
to an EMT. code, and is ordered In the seauenee of those 
eodes starting at 0. Thus, for example, since the code, for 
.INIT call is 6, the table entry for the .INIT routine is at 
MRT+14, The length of the table within any Monitor system 
naturally depends upon the range of the currently essigned 
codes* perhaps with snares, up to a maximum of 256 words. 

The 1 f not h of the MRT can be determi ned .by subtracting the 
starting addraas of the MRT (SVT+46) from the sterling ad- 
dress of the DDL (SVT*50) whleh Immediately follows It, 

The format of eaeh word In the table showa the current loca- 
tion _of the Monitor routine it represents, using the fact 
that for a valid PDP-11 address for execution access, bit 0 
must .be 0, l.a, a word boundary. The possible formats are 
Illustrated, at f1aure„2-3. It should be noted that two bits 
can sufficiently define the maximum number of 64-word seg- 
ments (or fixed-head disk bloeks) for env Monitor routine 
sfnee the largest swap area available Is 256 words (see Sec- 
tion 2.3). Moreover since the Monitor Library alwavs comes 
first on the system deviee, it is not expeeted that any Mon- 
itor routine will be stored beyond bloek *17777. 

The table-state needed for a user program run Is reached In 
three ataoest 

1. The MRT source Is set up to contain the global name 
pf each axlatlng Monitor routine In the appropriate 
position. During linkage of the permanently resi- 
dent Monitor Section with LINK-11 (see Section 
B.1,2) the core address for eaeh routine Included 
ia automatically set correctly into the table, 
LINk- 11 also zeroes the remaining entry words since 
their global references remain undefined. 

2. Whenever a eomolete Monitor hoot occurs, either 
from eold start via the ROM loader or following a 
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console FINISH command# the i ni t i al 1 eat 1 on routine 
(see Section 2.1.4) searches the Monitor Library 
( MONLIB) on the system device and resets. all 0 en- 
tries In the MPT to the relevant disk information 
(forget b# Figure 2-3) if the eorreseondi no routine 
is found or with 1 otherwise. At this time# the 
MRT is In its permanent state, A copy is stored# 
within the Monitor Library on the evstem devlee for 
later use (see be1ew),(l) 

3, If the user# bv a global reference in a program# 
indicates that a. routine normally storey only on 
the syatem-deviee ia to become resident while that 
orogram is running# the oregram loader (see Section 
9,1) Is so Informed by LINK-ll. The loader uses 
the d1«k, information stored in the MPT to brina the 
routine into eore and resets its MPT entry to the 
appropriate eore address. 

The MPT remains In the load-state throuahout the orogram 
runj .It cannot be ehangpd^for routines brought Into a Swan 
Buffer# because the disk information relevant to them must 
remain available for several Inter 1 saved eal 1 a# e.o. .INIT 
followed by .OPEN* then baek to .INIT again. The Swao Area 
Manager, therefore uses other method* to control the "resi- 
dency" of^these routines £see Section 2.3). when the pro- 
gram is finally removed from eore by .EXIT from the Program 
or pn a console KILL command, the MPT copy on the evstem 
device Is read back intompmorv to restore the teble to its 
permanent state. (see Section 6.9) 


2.1.3 novic e Driver List (RMQN1 ) 

Basically.# the Device Driver list (DDL) provides, the same 
Information as the MRT concerning the current memory or sva- 
tem-deviee locations of deviee drivers. However# unlike the 
other Monitor routines# the drivers mav be loaded into or 
removed, from memory In accordance with the dynamic reoulr- 
ments of a running program and thev do not use the Swap 
Buffen, Since they must be readily available to service 
program Interrupts whenever their device is In use# thev oc- 


1, As. stated# this write-out oecurs under normal running 
conditions, Henea at present the Monitor library on the 
svstem-device must not be wr 1 te-preteeted. 
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euov extra buffers frgm.free core. Henee each entry must be 
longer to contain additional infonmation. 

The resulting format of. the DDL. Is illlustrated et figure 
2*4. The significance of each item is as follows! 

1. Davies name • is. the radix-50 form for the alphanu- 
merie code assigned to each device. The only wav 
an. entry in the Hat ean be found is bv a seareh. 
This item therefore enables its identification. 

2. Cora Iced address - contains the stent. of the dev* 
ice driver when in core. Otherwise 0 indicates the 
driver's current non-residenev. 

3. Interrupt veeter address - is the start address of 
the two-word vector assioned to the device within 
memory locations 0*377 (or as otherwise provided) 
end is needed to permit the linkage of the driver's 
interrupt service routine to the vector when load- 
ed* (See Section. 3.2.1) it is held within the DDL 
rather than tha driver itself* because the user ean 
physically reassign devices to different vectors. 
This obviates reasf embl y . of the driver and also al- 
lows in-core modification# ayen though the driver 
at the time is available only in the externa! Moni- 
tor Library. 

4. System-device start bloek * gives the actual deviee 
address for the driver within. the Monitor Library, 
As for the MPT* no driver is expeeted to start bey- 
ond bloek #1777(8). 

3, * of 16-word blocks - enables determi nat i on of the 

size of the driver for claiming and releasing the 
buffer it ©eeuPies while in eore and for aoeeifying 
of # of words to be read# in order to perform the 
neeessarv lead (see Section 3.2.1). The six-bit 
eeeaeity. of the field allows a maximum driver 
length of IK# whieh is more than ample in most 
eases. 

6. DDL end - replaces the externa! address data in the 
fyf tern-device entry in the table# sinee the latter 
information la irrelevant when# by its purpose# the 
dr i vpr . f or such deviee can never leave memory. The 
provision of this item instead ajlows the DDL to be 
of variable size and henee contain only the drivers 
needed to support the particular configuration be- 
ing used. However it is essential that the svstem 
device entry is alwav the first in the DDL as shown 
in the diagram. 
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Tha DDL 4 S' established in the seme wav as was described for 
the mrt in the orevious Section, with the following exeeo- 
t lonsi 

a. A driver automatically becomes resident for as 

long as its current usage is reoulredt the user 
een gain nothing bv extending Its presence In 
memory for the duration of his program, (other 
than an occasional avsten-dey 1 ee aeeeas). 

Henee ha Is given no way of specifying this re- 
aul rement . 

b. Because eaeh Item in an entry serves a single 
purpose# there. Is no need for a re-1 nl 1 1 el i 1 1 ng 
baek-uo eooy of the DDL on the avatem-devlee. 

As indicated above# whenever the epogram initialises or re - ? 
leases a data set# the DDL Is searched for the device assoe1-\ 
ated with that dataset. Provided that aueh device exists 
within the system# the entry for the core address and the 
vector# through Its stored address# are both set to reflect 
the oreaence or abaenee of the driver In memoey Should the 
ppoopam.be restapted at any time# oephaels following a fai- 
lure#. the DDL Is. restored to Its Initial state# thus effec- 
tively removing normally non-resident drivers from eore (see 
Section 6.4) 


2.1.4 T able I nj tial 1 ft Ion (RMQM6 ) 

Jha permanently resident Section of the Monitor Is loaded 
into Its memopv area either by a eold start through the ROM 
bootstrap as described in the Prooammer’s Handbook or fol- 
lowing a console FINISH command (In order to prevent possi- 
ble transmission of Monitor corruption between users). It 
Is eeeomoanled by a routine which performs the function of 
establishing the correct Monitor state for normal usage# 
especially with regard to the tables described in the previ- 
ous sections. This routine# beeuoyino eore. above the normal 
end of, the resident Monitor, Is entered immediately after 
loading, After serving Its purpose It Is aubseouentlv 
over-wri tten# leavlno only a small Section whieh Interfaces 
to tha system error diagnostic print module (see Chapter 7) 
and a ^Buffer Allocation Table used to control operations 
within* free. eore (see Section, 2. 3) (hence the object module 
containing it must come last in the resident Monitor linking 
process - see Section 6.1.2) 

The tasks carried out by this special routine are as 
fol 1 ows i 


Detarml net Jon of eor* size • this Is accomplished 
by addressing cop*, start l.ng at 8K and then In staoa 
of 4K until an error trao through location 4 Indi- 
cate? the address used is no longer legal for that 
©articular PDP-11, The end address of the last 
valid 4K segment is stored as the top of eore In 
the 3VT. 

Provision of Buffer Allocation Table - as will be 
shown in Section 2,3 free cor* Is controlled bv a 
bit map reoresentat Ion, Currently th* size of this 
n*o provides for th* potential use of half of the 
available memory as buffer spaea. The routine 
therefor? prepares the aoprooorlete mao by clearing 
th* raouisite number of words at the end of th* 
Monitor area, These are followed bv two extra 
words reserved for Device Assiqnmant Table linkage 
(se* Section 3,),2,2) The map then becomes oart of 
th* resident Monitor# so data coneernino the mao 
and the consequent new Monitor end are entered Into 
the SVT. 

Initialization.©? processor trap vectors • since 
the Monitor itse]f uses EmT & IDT# the routine 
ftores.th* appropriate addresses and status values 
jn. their vectors In locations 30 and 2d, The rema- 
ining vectors are set to eause error messages If 
trapping oeeura#_the status value in eaeh ease oro* 
vldlng an identification code (within the Condition 
Coda bits) 

Initialization of devlee interrupt vectors - bv 
searching the DDL# the routine determines whleh 
drivers ware loaded with the resident system, it 
extracts Information stored in the Interface tables 
of these drivers (see Section 3,3) In order to set 
up the eorresoondi no devlee Interrupt vectors. As 
in stop 3 all other vectors are initialized to 
cause error message outout to protect against spu- 
rious interrupts before a non-resident driver# if 
sueh exists# Is available, 

MRT & DDL. ©reparation • as Indicated In the previ- 
ous sections# the routine establishes the Permanent 
state of these tables and stores a restoration copy 
of the MRT In the external Monitor Library. It al- 
so# from Its own Internal reference sheet# enters 
the EMT code used to call e*eh monitor module Into 
the Library index on th* avatem-devl ee (see Chapter 
1), This enables LINK-ll later to identify to the 
program loader those modules for. whleh a user has 
specified proaram run-time residence (see Section 
3,1), It should be noted that the whole Library Is 
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searehedt should there he more then one version of 
e Monitor module or driver* the lest one seen will 
he catalogued In the eopreorlete table. Thus It is 
possible to make temporary changes to the Library 
merely by adding a new version at the end during 
system loading. (see Section 6.2,2) 

6, Clock-initialisation - If a clock-service routine 
is contained within the resident Monitor end a 
llne-eloek la determined to be Included in the con- 
figuration (because no error oeeurs if it Is ad- 
dressed)* the eleek's interrupt is enabled to set 
it in motion. 

On completion of these tasks* the initializing routine links 
the resident Keyboard Listener described in Section 6.3,1 to 
the console Interruot vectors* prints out e Monitor Identif- 
ication. message and exits to await operator Instructions 
(uslna • XIT • see Section 5.5) 


2.2 EMT Handler (RMQ N2) 

It was shown in ehaoter 1 that all ealls for Monitor assis- 
tance j#r? by way of an EMT Instruction with its junior bvte 
coded ,t$ indicate the particular service reoulred, It is 
the orlmerv function of the Emj Handler to deeode the eall 
and make the neeessary connection to the routine providing 
the service. The Handler also ensures that I/O reouests In 
particular do not proceed unt i 1 r 1 t is currently safe for 
them to do so end contains its own routine to effect any 
eonseouentlv necessary wait. 


2.2.1 Description of the Handler 


An outline of the Handler’s processes is given In figure 
2-6. This shows that the first step is a move of registers 
0-5 ontp the processor stack to preserve them for the user 
program. This serves two pureosesi 

1, All the service routines ean thereafter use the re- 
gisters freely. However. It Is then their responsi- 
bility to replace the original contents before any 
exit to the user prooram. 

2. It will be shown In Section 2,4,1 that the subrou- 
tine entered to effect the save also checks the 
state of the processor stack to protect the Monitor 
itself. Thus this eheek Is imposed as freouently 
as the Monitor Is eelled. 
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The Handler. then v«r<f|ei that the EMT eode used H«i within 
the established range (0-77), An inv*Hri eode should never 
occur if the eallina program is working correctly. If It 
does# It is therefore trgated as a fatal errpri the program 
Is stopped and an appropriate error meseaee Is output at the 
console (F002), 

The Handler's nest action depends yeon the nature of the re- 
quest In eaeh case. Under DOS# In feet# the EMT codas are 
assigned on the following basis! 

1. Codef from 0 throuah 27 signify reauests for I/O 
services 

2. All other reauests have eodes in the ranae 30*77 

No further checking Is needed for reauests in the seeond ca- 
tegory. The Handler therefore extracts the entry# corres- 
ponding to the eode within the MRT described In Section 
2.2.2. . It was shown there that If bit 0 of the entry Is 0#^> 
the entry Itself Is the eore start address of an already re-V 
sjdent routine. In this ease# the Handler uses the entry to] 
dispatch immediately to the routine. On the other hand# a 1 
In bit P of the entry means that the routine must be brought 
Into memory before it can be used. The Handler therefore 
ealls the Swap Area Manager to affeet this (see section 2,3) 
and passes on the MRT entry on the too of the processor 
staek to identify the routine required. 

As notec) earlier# I/O request? are not allowed to continue 
while, It is unsafe. In their ease# the Handler cheeks for 
two possible situations as follows! 

1, The Programmer's Handbook shows that In ell 1/0 op- 
erations# the user program must suoply a Link-block 
for eaeh dataset to be used and must Pass Its ad- 
dress as one of the parameters at each call. Once 
a dataset has been eorreetly initialised by a ,INIT 
request (see Section 3.2. 1.1)# a link-word In the 
block# l.e. the on? actually addressed# Is set to 
a non-0 value. Using the given parameter as means 
of aecess# the EMT Handler examines this word and/ 
releets all, ealls other than .INIT If It conta1ns( 
0. This again, Impllea prooram failure and results > 
In a fatal error message (F000), 

2. It will be shown In Section 3, 1.2.3 that the value) 
set into the link-word bv .INjT is the address of a(_ 
control block for the dataset within the Monitor 
area known as the DDB, The addressed word 1* the 
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DDB 1# a flao which is set to only when thera Is 
no. other I/O ooeratlon currently underway. If bv 
looking at this word# the EMT Handler sees that the 
dataaet is already busy# It sets uo a looo aeguenee 
within Itself until a later cheek shows otherwise. 
This looolng does not happen# theuoh, if the actual 
eall Is .WAITR. In this ease, the Processor stack 
Is, adjusted such that after restoration of the user 
Program Registers and removal of the call ©arena* 
ters# an exit is taken at the busy return address 
given as one of these Parameters (see Illustration 
at figure 2-6) 

If neither situation Is encountered (or after the second has 
dl sapoeared) # the EMT Handler claims the dataset for the new 
reaueat, (unless It is. .WAIT or . WAITR) by storing the ad- 
dress of the cell In the DOB buav flag. It then uees the 
seme ©reeesa to disoate.h to the relevant service routine as 
that described for non-I/O reauests. At this eolnt# of 
course#. the purpose of .WAIT or. WAITR hes already been sa- 
tisfied. Hence no further processing Is needed and the EMT 
Handler uses a similar seauence to that Indicated for .WAITR 
In the busy state to take an Immediate eomoletion return to 
the user program. 


2.2.2 general Comments 

From the deeerlotion olven In the previous Section, it ean 
be ,Sfe? that the EMT Handler does not attempt to verify the 
validltv of the parameters oassed bv the program at each 
call. In part 1 eul ar , _ 1 1 assumes that the link-block olven 
with I/O requests does in fact contain a true 00* address. 
Thus it depends greatly upon the u*er respecting the Integ- 
rity of date set into his program area by the Monitor. A 
check in this case could be simolv accomplished from data In 
the DOS's held by the Monitor. However this would involve a 
linear search which could become lengthv. Since In the sin- 
gle-user system currently offered bv DOS# the user ean only 
eor rupt c h 1 mael f » the eheck has therefore been omitted bv In- 
tention. .In the general ease# of eourse, the EMT Handler 
has insufficient Information to carry out the reoulslte 
checks. It Is thus the respons i b i 1 1 t v of the called service 
module to take relevant aetlon. 

To provide each routine with as Immediate an aeeesa as pos- 
sible to the data )t needs# the EMT Handler always passes 
the following appropriate Register contents* 
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Rl ■ staek address of the last call oara^eter 
pushed by the program 

R2 » address of the relevant EMT call In the uaer 
proqram 

R5 ■ address of processor Status Register (or *2) 

In addition# for I/O ealla other than ,INIT» R0 remains at? 
the address of the DOB* for all other calls* it Is cleared, 3 

The prlpritv level at whleh.the Handler operates merits ex- 
planation. In general* It uses the level of the calling 
program, However If this should be 4 or above* hardware In- 
terrupt* needed oerhaos to terminate an enforced .WAIT as 
described earlier eould be locked out. On the .other hand* 
at Ipvel 4* conflicts mloht arise if the user intervened at 
tha console- .Thus tha oanaral level Is kept at .4 If the 
prooram is higher. On entry nevertheless* orloritv level 7 
Is set. in order to ensure that the cheeking of the 
stack-state can be effected without Interrupt Ion* but Is 
dropped. as soon as possible thereafter (taking approximately 
70 usees). Level 7 Is again used while the Handler cheeks 
the busv state of a dataset. The cheek eouldbe corrupted, 
if an interrupt were able to claim a dataset for another op- 
eration after conditions were already set to indicate Its 
being available for the .Interrupted reoueat, (in the ore- 
sgnt 008 of course* this cannot happen* hewsver_lt was pro- 
vided against a possible future expansion for real-time 
use.) 


2,3 Swap Area Management 


(RM0N2) 


Two buffer areas are reserved within the resident Monitor to 
accommodate Monitor modulfs whleh are brought Into core only 
uoon program demamd. It is the responsibility of a neces- 
sarily resident Swap Area Manaoer (SAM)* to control the us- 
age of these buffers, when asked by the EMT Handler to load 
a non-resident module* SAM checks the occuoanev of the ap- 
propriate buffer* If the called routine is. already loaded 
from .a previous reouest and provided that it Is Idle or* If 
not* that it is reentrant, SAM passes control to it Immedi- 
ately. Otherwise* SAM loads the ealled routine from the 
svstem-devlce If and when the current occupant has completed 
Its function. Until the routine Is then able to take over* 
S*M keeps, control within the Monitor by returning to the EMT 
Handler to loop and wait. 
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2*3.1 Swap Buffers 

The format of a 3 wsd Puffer has been deafened to enable res* 
aonably efficient machine utilization within the constraints 
of a single-user system. The main considerations ere re- 
fleeted In the Items included In a preamble to the Swao 
Buffer es Illustrated In flours 2-71 

1, neeuoant * this baaleallv allows SAM to re-use a 

eeoy of a called Monitor routine already loaded in- 
to the Swao Buffer to satisfy a previous request# 
rather than force an unnecessary wait fob • co- 

sy to be brought from the system-device. In order 
that the current occupant may always be . 1 dent 1 f 1 ed 
SAM saves the unioue avatem-devl ee Information 
o eased on bv the EMT Handler from the mrt (see Sec- 
tions 2,t.2 end 2.2,1). 

2, Usage Count - this protects the current , occupant 
from orem.atyre "removal" before It has fully met 
its eutstandina commitments. Many of the M 0 nit 0 r 
modules# esoeelallv those Providing I/O services# 
are likely to be unable to eomolete a reouest Imme- 
diately beeeuse th$y must wait, upon the performance 
of some I/O operation. Any routine may In this 
case. return to the user Program to allow other pro- 
cessing to proceed Instead of keeping the system 
Idle* However the program may then make a_new ser- 
vice reouest requiring use of the Swap Buffer for 
seme other routine. It may even be a reouest upon 
the same routine whleh In many cases can be accent- 
ed before the first has been completed. Thus SAM 
exoeets to use the first bvte of aaeh routine it 
loads as a counter for the number of times control 
is passed into the routine and the routine Itself 
eounts beck the number of times it completes a task 
(see Sect 1 on 2.2.3) , The buffer Is then deemed 
free only If the counter has returned to its entry 
settlna of 0 . 

3, ^e^entramcv switch - this allows eaeh routine to 
inform SAM of Its re-entrancv capability. Some 
Monitor routines cannot accept a second reouest 
while another Is In Process, a principal reason be- 
ino that the service thev provide Is too complex to 
be completed within the capacity of the Swap Buffer 
and they must therefore overlay themselves to eooe. 
SAM therefore onlv recalls e busy routine If It Is 
safe to do so as Indicated bv a 0 in the seeond 
byte of the routine. 
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4, Start address ■ because the first word of eaeh rou- 
tine is thus allocated as a control area* SAM 
enters the routine at this point(l). 

Two 3wao Suffers are in fact included in the resident Moni- 
tor area* 

1, Monitor Swao Buffer (MSB) ■ 25B|Q words - this is 
aenerallv used bv ell orogrem.serv i ce nodules. 

2. Keyboard Swao Buffer (KSB) ■ l2^ 0 words * this is 
mainly reserved for consol e-servi eing, in order to 
allow overlapped proeessino between a running pro- 
gram and external operator action (see chapter 6), 
It is also used for emergency operations# sueh as 
error diagnostic orintino (see chapter 7)# espe- 
cially when the reauest for these mioht easily ori- 
oinate within the MSB and obvious eonfliets would 
then oeeur. 


2,3.2 Calling SAM 

As noted in Section 2.2.1# SAM is normally entered from the 
EMT Handler, At this ooint# certain Registers are set to 
values indicated in Section 2. 2.2f these must be passed un- 
changed to the called routine as this may depend uoon their 
content (lust as if the routine were called direetlv from 
the EMT .Handler# in other words). The user program Regis- 
ters are on the at aek with system- device information on the 
routine to be fetched bv SAM, as shown in the mbt# above 
them. 

There is a second way in whieh SAM can be enteredi It can be 
colled by its own reserved EMT eodes (3 fl and 40), This spe- 
cial entrv is provided mainly for internal Monitor usage as 
a. means .whereby a seamented routine ean overlay itself in 
either buffer • henee the two codes# for reasons to be shown 
shortly. In this case however# the MRT eannet supply the 
date on the location and size of the overlay on the svstem 
device., Henee the calling routine must do so in the same 
format in R0, When SAM is then called, the data is on too 


1. When, as indicated jn Section 2.1.2# the Program Loader 
sets the M RT for routines made resident for a preoram run# 
it also uses this address rather than the aetual start loca- 
tion (see Section 5.1.) 
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of t hs stack as saved bv the standard Reg '(star* save o roc ass 
of tha FMT Handler (saa Section 2.2.1). It Is duplicated on 
the ataelc at the soeelel entrv end thus conditions beeome 
sat exactly as for tha normal entry described in the Drevl- 
ous paragraph. 


2.3.3 Description of SAM 

Figure 2*8 olves a general outline of SAM's processing oper* 
at 1 ons . 

The first main step taken Is to cheek whether the routine 
reguested does in. fact exist. As shown In Section 2.1,2. 
the MRT entry contains a 1 in such eases. If this is seen. 
SAM uses the EMT Handler error seauence to ©reduce an F002 
diagnostic as shown In Section 2.2,1, 

SAM must then determine whleh Swao buffer Is to be used. 
Routines whlph are loaded Into the subsidiary K3B have In 
fact been .assigned EMT codes in the ranee 30-37j ell other 
eodes imeilv msb use. SAM seta a pointer to the appropriate 
buffer and also one to an Internal DDB by which the svstem 
device will be controlled (see Section 3,1. 2.4), The flag 
In this. DDB Is cheeked in. ease the driver is currently an* 
gaged In loading a routine, SAM continues only If this Is 
not the ease. 

As described in the previous Section. SAM thereafter uses 
the identification for the pccuoant stored in front of the 
buffer to check whether the routine now reoulred is already 
loaded ^and if so whether It is Idle or re-entrant, on the 
basis^of the setting of the first two bvtes of the noutlne 
Itself, If the correct conditions are seen, SAM transfers 
control Into the routine, havlno Incremented its Usage Count 
bvte to Indicate a fresh entrv. 

If the eeeuoant of the buffer Is some other routine, 3A^ ex- 
amine! its Usage Count, If It Is 2 slgnlfvlno that the rou- 
tine is.no longer needed, SAM stores the svstem-deylee in- 
formation for the called routine as oceupant- 1 dent i f 1 er end 
then decodes it to set uo the Internal DDB aporopr 1 atel v 
(see Section 3, 1,2. 3), The system-device driver is called 
to perform the necessary transfer through the Driver Queue 
Manager, S.CDB (see Section 3. 1.2, 4), 

While the transfer is In orogress or If the previous checks 
show that the avstem-dev 1 ce driver is already engaoed In lo- 
ading a Swan Buffer or that the reoulred Puffer is not yet 
free for alternative use. SAM returns to the E**T Handler to 
loop and wait. This in fact repeats the whole process of 
decoding the cell with the exception of user Register saving 
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(set Section 2.2.1). THe serves three pureosesl 

e. Registers are reset to the required content for 
entry Into the ealled routine, _ Thus SAM does 
not need to save their content In order to use 
them whll oreperlno the transfer. 

b, SAM Is reentered as or iginal 1 y. ever In the soe- 
elal ease noted In the previous Section. By 
the subsequently normal Procedure# transfer of 
control to the routine oeeurs naturally as soon 
as It has bean leaded, 

e. Jf may sometimes happen that as a result of an 
Interrupt SAM is aakedto lead a different rou- 
tine Into the same buffer, even before th® ori- 
ginal request is satisfied, a.o. The DECtaoe 
driver might wish to print an error message be- 
cause of hardware, failure Just when the opera- 
tor has struek a. console key and the Keyboard 
Listener is bejno leaded. The general proce- 
dure deseribad^wi 1 1 in this ease honor the sec- 
ond request first. However conditions remain 
such that the servicing of the interrupted eall 
ean be resumed afterwards. 

Nevertheless, this method creates a problem for I/O calls. 
By the t1mq that SAM is first entered, the £MT Handler has 
already made the dataset busy upon the new cell. If SAM 
merely returns, .the EMT Handler will see conditions appro- 
priate to an Implied .WAIT as described In Section 2,2,1 and 
SAM will not regain the necessary control. Hence, together 
with the slight matter of clearing the data passed by the 
Handler from the stack, SAM removes the bysy-state from the 
dataset . (using the content of R? to recognize I/n calls - 
see Section 2.2.2) 


2.3.4 System Exit 

It can be seen from the previous Section that Sam does not 
ask to_be recalled bv the system-device driver when the lo- 
ading of the reoulred routine has been accomplished, SAM 
merely requests the load and then decides when It can 
transfer control to. the, routine on the basis that the driver 
Is no lonoer working on the system's behalf and the appro- 
priate Swap Buffer is now oeeupied by the routine in an idle 
state. 
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Instead of the recall* SAM in feet, throueh a Completion Pa- 
turn Address set Into the internal DDB direct* the driver to 
a seeeiel seauenee. This firstly free* the driver for al- 
ternative use throuoh the Driver Deaueue Routine# S.CDQ to 
be described in Section 3. 1.2. 4. It then checks that the 
transfer ha* been satisfactorily carried out and if not aeta 
up the ultimate fatal error - a System Halt - because it 
must now be assumed that the device can no lonoer support 
the avatem. If all is in order, the .DOB husy-flaa is 
cleared, to inform SAM that the transfer ia no longer under- 
way. Finally* ainee the seauenee is executed as part of an 
interrupt from the system-device (sea Section 3.3), Regis- 
ters saved by the driver are restored and an exit to the in- 
terrupted routine is taken (bv PTT). 

The last part of this seauenee* Regi ster-restore & exit, ob- 
viously complements the trap & Register-save seauenee whieh 
begins the FMT service a* described in Section 2.2. Thus it 
is the oath which all Monitor routines must take to return 
to the palling program. Furthermore, it was shown .in Sec- 
tion 2.3.1 that if one of these routines is in a Swap 
Buffer, it must also decrement the Usage Count in its first 
bvte whenever it completes a task, in order to free the 
buffer for other use. It. cannot do this while it js still 
in the buffer* in ease this is re-allpeated before it exits. 
The decrement ia therefore included in the ^seauenee dis- 
cussed $bove (bv-oassed in SAM's ease) and this is 
identified as the System €xit with an appropriate address 
set into fixed vector location 42 as the means of aeneral 
access. (1) For the general ease* this is* 

S.XITl OECB MSB. >ENTRY FOP U/C DECREMENT 

J3R R5* S.RRES t GENERAL ENTRY 
PTI 


2.3 ,5 . T he Swappable Routine, 

The previous sections have shewn that any routine which is a 
potential user of a Swap Buffer muat be set uo within some 


1. The whole seguenee including the device transfer validi- 
ty eherk must not be changed • different routines enter it 
at various Points on the basis of a fixed relative to posi- 
tion to the address stored in the vector location. 
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const ra,1 nta because of this. Since ell the Monitor rou- 
tings* ©then than those whleh normally reside permanently In 
memorv and the devl ee-dr 1 vers* come under this headina* they 
all have common Inherent features as a result. .This section 
summarises these features. Its ouroose Its twofold! 

a. It provides an Introduction to the modules ore* 
aently Included within the Monitor, 

b. It lays iouj the ground-rules whlehmust be fol- 
lowed during the development of new modules 
(see also Section 8.3) (1) 

Because SAM expects the first. word of the. Swan buffer to be 
Usaoa Count & Re-entrancv Switches* as diseussed In Seetlen 
2*3. 1* all routines begin with a word In a format or 

■1*0, The Junior 0 byte then eorreetlv initialltea the 
Ceuntf The hioh-bvte aettina indicates the routine's ability 
to service several reouest s together. 

It should be noted of course that the protection afforded by 
the -1 setting of the Re-entranev Switch does not mean that 
the routine can then break the rules which the term 
* ra«ent nent " normally Implies. The switch only prevents SAM 
from allowing a second reouest to pass before a first has 
been completely satisfied. Moreover the fact that a routine 
Js ooientlallv swappable also signifies potential residency 
in which ease there If no SAM to Intervene. Hene« as far as 
posaib]e most.routlnes trv to observe in particular the need 
tp avoid anv form of self-modification, either in executable 
eode or temDorany data storage. That they are also 
post 1 on - 1 ndependent reellv ooes without savins. 

Because the first word of eaeh routine is thus reserved* all 
executable seguenees beoln at. the seeond word. As a result* 
the global reference Identifying eaeh routine for possible 
linkaoa into the resident Monitor (see Section 2,1.2) Is 
made et.this oolnt in the Assembler Source for the routine 
rather than at the start. 

Jn oeneral#, all routines end with e cell to the. System Exit 
via location 42. (There are exceptional see in particular 
Section 4.3), Thus they meet the retirements for restora- 


1, Console service modules* for other reasons* must be con- 
sidered special eases in that some of the comments do not 
apply. Therefore the reader Is referrad to chapter 6 for 
further detail. 
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tion of us«r Register. contents and release of the Swap 
Buffer as. discussed Jo the previous Section*. Potential re- 
al Oency « however# again raises a problems a routine must ob- 
viously, not decrement the Usage Count in the Swap Puffer If 
It la net eetuallv eeeueylna the buffer* Henee eeeh routine 
muat determine whether in fact this ateo must be taken, The 
fact that the count la only Incremented In the first diace 
when S4M gives control to the. routine offers the solution. 
If the routine ia resident and is accessed dlreetly from the 
EMT handler ea shown In Section 2,2, 1# the Increment does 
not occur. Thus a eommen form of exit as It appears within 
eaeh routine is 1 1 1 ust reted. bel ow, assuming that location 42 
eontalna the address S,XIT illustrated in the previous sec- 
tions 


MOV M42/R5 
tstb start 

BNE , +4 

CMP (R5) ♦ # (R5) ♦ 
JMR SR5 


f COLLECT SYSTEM EXIT ADDRESS 
ICHECK IF USAGE COUNT SET 
»IF SO ROUTINE IS IN MSB 
iOTHERWISE OMIT DECREMENT 
f (SECTION 2.3,4) 

» GO TO SYSTEM EXTT 


The ijmlted size of the Swap Puffer naturally imposes res- 
trictions. on each routine. In most cases, this does not 
matter# since. the service, reouired Can be simoly accom- 
plished. within the available capacity# but not In all 
however* T h ua some routines must overlay themselves to aet 
the fob done* If such, oyer 1 pyl no can be. done sequentially# 
l.e. bv eaeh segment completing a specific portion of the 
sequence and then passing to the next without a need for re- 
call# the soeelal SAM entry described In Section 2.3*2 may 
be used (see Chapter 0). However this raises other problems 
of storage within the svstem-devlee library - see especially 
the ^ascription of console service modul es# . wh 1 eh . use this 
technique# in chaoter 0* An alternative method, which also 
covers the. non-seouent 1 al ease# (but nevertheless uses up 
EMT cedes) la dlseussed under Ei 1 e-st ructures In ehepter 4, 
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2.4 Siw>p>l Purpose Sub-rout i nes 


(RMQN3) 


This Section introduce® • set of sub-r’eut 1 nes providing aer- 
vieei of e general neture for many other Monitor modules* 
including tho®e In the Permanently re®ident portion, They 
alto .ere resident! they ere modeeatel V, short end the fre- 
quency at whieh thev ere needed makes it impractical to load 
them from the svstem-devlee every time, 4s noted In Section 
2.1* they are accessible by mesne of the system vectors In 
loeetions 44*57. 

There ere altogether slit sub-routines in the set. However* 
thev foil noturslly Into three ©airs since* In eaeh of the 
three efses* whet one_sub-reut ine does* the other undoes. 
Thus any eell^to the first must be complemented bv a eall to 
the second before any original state ia regained. The three 
pairs arei 


1, S.RSAV/S.RRES Reoleter save ft restore 


2. S , GTB/S , RLB Allocate ft release buffers 

3. 3.CDB/S.CDQ Queue ft deoueue driver requests 


Of these* onlv the first two will be described in the fol- 
lowing auctions, The thl.rd pair, being dedicated to I/O, 
will he dlscuased In more aoprooriete context In chapter 3, 


2.4,1 Peoiater Seye/Restora ft Stack Control 

In the main* the 008 Monitor has been designed to supolv Its 
service® tg the u®er while stjll pllowlng him to take full 
advantage of the hardware capabilities of PDP-11. Hence* 
rather than impose unnecessary rest ri et 1 ©ns upon hia use of 
Registers* the Monitor guarantees their contents bv ssvlna 
them on the processor stsek whenever and for whatever reason 
control passes from. a user’s program and restores them be- 
fore eueb control is returned,. In. thg Interim, the Monitor 
can than freely use the Registers for Its own purposes. 

For the general esse* a,1 1 the registers are likely to be 
needed. Thus the common subroutines S.RSAV and S, ORES with 
entry .through locations .44 ft 46 are provided. The first 
aimoiy "pushes" R5 through R0f the second "oegs" them In re- 
verse. Both are ealled In the same manner ast 

I FOR S.RSAV-OR »4S» F0» S.RBES 
fAUTO-SAVE P5 IM CALL 


MOV SS44, - ( SP) 
JSR R5,S(SPW 
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(Dlreet etlHng la of eourae possible from within the nor- 
mally permanently resident Monitor modules, e.g. J8R 
R5, 3 , R3A V or JSR R5«S.RRES). 

The processor stack Itself is another eonslderat Ion. Again 
the user is not asked to refrain from adjusting the stack 
pointer (SP or R6) to ault his needs, .The Monitor merely 
provide* Its. initial setting. aoprooriately. However, thep 
Monitor Itself and anv buffers it has established on the r 
user's behalf ace Jo a vulnerable position for corruption bv -> 
the staek. Hence the Monitor must try to provide some pro- 
t act 1 on s 1 ml 1 ar to that affp.rded bv the PDP-11 hardware for 
the vector space below location 400. 

Thera are In fact three situations to be considered! 

1. As a result of normal push operations or of adjust- 
ment to SP, the stack drops below a danger line and 
Is still there when a check is made, 

2. Tha staek is, pushed below the line but Is popped 
baek again so that at anv check, SP is seemingly In 
a harmless position. 

3. By adjustment, SP Is moved below the line, where It or 1 

Is used to store data, end Is again returned out of r*ynr ey 
ham's way before it Is eheeked. 

The Monitor can readily, cope with the first two situations. 

At al.1times.it maintains a pointer to Its own dynamic and, 
namelv that for Its own permanently assigned memory area ex- 
tended bv modules loaded for a program run and bv eurrentlv 
assigned buffer soaee with a small safety margin. This oo- 
Inter, is stored In the SVT as Top of Buffers (TOB) ■ see 
Section 2.1.1. A simple comparison of this against SP is a 
sufficient cheek for the first ease. At the same time the 
Monitor sets a bit pattern into Its end word as. shown bv 
TOB. Jt is highly probable that this pattern will be cor- 
rupted In the second situation and a simple eheek resolves 
this. 

The checking operations must of course be carried out as of- 
ten as Possible to be effective. Since Reol ster-sav 1 no 
through subroutine S.R3AV. normal 1 v occurs as the first steo 
whenever the Monitor oains control for anv length of time, 

(see the EMT Handler In Section 2.2.1 and device drivers In 
Section, 3. 3), the check Is Included at this time. If a vio- 
lation Is seen, 8.RSAV moves SP back to allow collection of 
the Error Diagnostic Pr 1 nt rout 1 ne from the system-device 
and requests the output of a fatal E0$i message (see Chapter 
7). A problem can happen though. If the violation is bv the 
svstem-deviee, especially when working on the Monitor's be- 
half, As a result, for this ease, the svstem-deviee Is el- 
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lowed, to oroceed to completion • the violation i • pieked up 
1 ater. 

It is obviously possible that the Monl tor. 1 tael f is the of* 
fender and not the user. It might therefore seem naeesaary 
that thp cheek be made not only on entrv hut also on exit# 
1,0ft in S.RRES as wall. However In most eases* the 
Monitor’s wholesale usaoa^of the staek is confined either to 
Savina .Registers or# If not# is. followed by such aetion. 
Thus anv violation la aeen almost immediately. The addi- 
tional overhead of checking again every time# merely to 
eateh, the outside ehance of this not alwavs being the ease# 
la too excessive and so the eheek Is omitted from S.RRES, 

Unfortunately# the Monitor has no way of providing for the 
third situation • even the hardware protection does not ade- ~> 
guately eiqver this,. It Is only the user who ean therefore V 
prevent it* Thus in the Programmer * s Handbook, he Is asked _> 
to exerf 1 so, eare If. he adtusts SP for iny pureosi. To as- 
sist him in knowing where the danger line la* the Monitor 
provides a means by which, he pan ask#, within the General 
Utilities call Caea Section 5.2), He is also advised to wa- 
it until he has completed I/O set up operations (i.e, .INIT 
t .OPEN) before making the adjustment as there Is then less 
ehanee of running Into trouble, Figure 2-9 la given to Il- 
lustrate the advantage of doing this.. 


j2.4.2 Pres Core Management 

As indicated in chapter 1# the Monitor uses free eore soaee 
above, Its and as an area in whleh It sets uei buffers In sup- 
port of a. user program's reouests for I/O services. The ar- 
ea .Is ouite dynamic in that as demand increases so does the 
buffer spsee provided and likewise when the demand gees 
awav,_ Thus et anv time the total area currently allocated 
la defined from the start of the first available buffer as 
stored _aa end of Monitor (EOM) in the SVT to the end of the 
last buffer still In use (with a 16-word safety margin) as 
shown bv TOB in the SVT (see previous section). 

In order to control the. allocation of buffers and their 
later release# the Monitor maintains a bit-mjp for. the free 
core area. This is merelv a number of words in which eaeh 
bit represents a 16-word buffer soaco, As noted above# the 
map Is alwavs orialned at EQMi thus t h e first 18 words above 
this correspond to bit 0 of the first map word. Bits ther- 
eafter are numbered from night to left. The length of the 
table and hence the area It potentially controls is esta- 
blished at Monitor Initialization (see Section 2,1,4), 
Presently half the available memory is set as the absolute 
limit. Bits are cleared to 0 while the buffers they reore- 
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sent are fi *eej thev are raaet to 1 wh«n the buffers are as* 
signed, Tha and of the whole current buffer ^rea denoted bv 
TOB therefore 4s also marked bv the last mao bit set to 1. 
(see Ffoure 2*10). 


2.4.2. 1 Buffer Allocation 

The buffer allocation 4s effected bv a call to sub-routine 
S.GTB with access through vector location 54, The total 
soaea required must be suooliedy this is done bv oushino the 
number of 1 6- word units onto the oroeeseor stack as osrt of 
the eal 1 # e.g. 

MOV #4,-(9P) »64*W0RD BUFFER RETD. 

MOV e#54,-(SP) icall S.GTB VIA VECTOR 

JSR R5,e(3P)+ 

provided that the neeessary space is available# tha subrou* 
tine , returns }ts start address on the stack-topi P is used 
to show non-avai 1 abi 1 i t v, . 

The allocation oroeess functions as follows (see also Figure 
2-ll)t 

1, Save the eal 1 4 ng rout i ne Registers & set oointers 
to COM .4 the bit map start (shown in SVT as BFS - 
see Section 2,1,1,) 

2, Find the position in the map of the lowest 16-word 
buffer available on the basis of the first 0 bit. 
At, same time maintain a pointer at tha and of the 
buffer unit heina checked, 

3, Check if sufficient contiguous 16-word units follow 
to meet the specified number. If not, repeat step 
2 and step 3 until tha map-end stored in SVT as *FE 
is reached. If this occurs# exit with 0 on top of 
the stack. Similerily if at any tim#» the end of 
area beina considered moves into the processor 
steek area# do likewise. 

4 , If the total required area is available# update TOR 
and reset the stack-stop pattern word (sea previous 
Section) as neeessarv. 

5, Set appropriate map-bits to 1 to show the alloca- 
tion# store the start address of the area on the 
stack# restore the saved Registers and exit. 
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2.4.2. 2 Buffer Re least 

Buffer release Is performed bv s csll to subroutine S.RLB 
whleh uses location 5« as Its vector. In this ease, two ar- 
guments must be oassad - both the start address of the 
buffer area belnq reljnoulshed and Its size In 16-word un- 
its. This olves a calling aeouenee asj 

MOV #AD0R,-(SP) (GIVE BUFFER ADDRESS, , • 

MOV *N,-(SP) (...& SIZE 

MOV S#56,-(SP5 (RELEASE IT, 

JSR R5,#(9PU 


provided that, the arguments are apparently valid, the appro- 
priate map bits are cleared to <3 and TOB Is ed|usted to the 
end of the last buffer still allocated. The stack is 
cleared on exit. 

The release Is effected as follows (see also Figure 2—125 s 

1, Say« the calling routine's Registers. Set relative 
pointers to the start and end of # the area to be 
freed, based on The parameters supplied, Exit with 
the staek clear If, the area is outside the range of 
the mao or if no else is given. 

2, Compute the bit position for last 16-wgrd unit In 
the area specified and set e mask accordingl y. 
Again exit if the supplied address does not coin- 
cide with a correct 16-word unit start point, 

3, Clear appropriate bits in the mapf at the sa m e time 
track the start of each unit being released, 

4, If the end of this buffer is also the end of the 
whole area presently allocated, continue tracking 
until either a 1 bit or the start of the rap Is re- 
ached, Reset TOB and Its staek-stop accordingly, 

3, Restore saved Registers, elean-uo staek and exit. 


2. 4 . 2 . 3 Comments 

It should.be noted that once a buffer is assigned to some 
purpose. It remains eg assigned, even though units before it 
may ba released first. Reshuffling to prevent oaos Is not 
considered worthwhile when this mloht mean the necessity of 
maintaining extensive data on the role of each buffer. 
Instead S.GTB attempts to fill up any gaps before claiming 
more free core (see step 1} and S.RLB ensures that not only 
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the specified buffer but alee anv ereeedino oao la returned 
to free eore (see stem 4). The user ear also keep usage to 
a minimum by taklne eara in his aeouence of reoueats for 
routines eayaina buffer allocation ( . INIT' a* .OPPN ' a) . Thus 
this la advised in the Programmer 1 a Handbook, 


2.5 Tin e Control 

provided that the cenf lourat Ion Includes a line-eloek, DOS 
maintains. the tine of dav (TOD) in two words within the SVT 
(aae Section 2,1,1) aat 

TOD* .WORD 0,0 

where TOD represents the hlah-order 15 blta and T0Dt2 the 
low-order 15 blta of tine In eloek tlcka. 

The aiart in both eaaea la positive, l.e. 0. The value la 
initialized by means of the cenaole TIME command (aae Sec- 
tion fl.4.) 

The. eloek Itself la set. In motion when the Monitor inltlall- 
aation routine enablea Its interrupter aaaumlno that the re- 
aulalte driver haa been Included within the_bermanent 1 y re- 
sident Monitor (sea Sect 1 on 2. 1.4) . Thereafter, at eaeh In- 
terruot. the driver merelv performs a double preclalon In- 
crement of the atored value. If does not however attempt to 
make 24«rhour adjustment or anv form of calendar cheek, both 
of which would Inereaee the dn1ver»a size. The operator 
must therefore reset the atored value dally, again by a con- 
sole TIME entry. 
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GENERAL 


CHAPTER 3 

I/O PROCESSING 


Bv far the malor function of the 003 M e *ftor < 9 to relieve a 
running orograr of the. problems Involved In moving Its date 
between .the, P f5 P • 1 1 and its peripheral I/O devices, Moreover 
while, Performing this function, the Monitor alma at meetlne 
the following criteria! 

i# Cora eeonomv • usage should be restricted to the 
mining* needed merely to aervlee the I/O ODerationa 
currently underway. 

2, Machine efficiency ■ as far as possible the orogram 
should be allowed to continue alternative process* 
ino while waiting for normally relatively alow I/O 
to complete, 

3. Oeylee independence • if he so wishes, the user 
should be able to delay specification of the aetual 
devices to be used bv the Program right up to the 
point of execution. 

Shared usaoe^of bulk media -.the storage and retri* 
aval of different sets of data upon bulk media 
should be comparatively simple for one user or sev- 
eral, with some measure of mutual protection. 

The purpose of this ehaoter is to, show how the firat three 
of these goals have been spoiled for all devices, regardless 
of their neture. Section 3.1 further dlseussps the princi- 
ples and explains the general control techniques employed. 
Section 3.2 describes In detail the routines whieh provide 
eommon processing services for all devices. Section 3,3 il- 
lustrates the general format spec 1 fl ed for the drivers whieh 
control the devices on behalf of those routines. 

The fourth objective is. the principal subject. of ehaoter 4, 
This .will also show hew provisions covered in this chapter 
are extended when thev are applied to bulk-storage devleea 
1 n part 1 cul ar . 
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3.1 I/O Concepts and Control 


The. purpose of thi# aeetlon 1# to ahow hew .In general the 
Monitor attempt* to aatlafv the thr#e main objective# tor 
all I/O. defined In the 1 nt roduet 1 on, The overall strategy 
la deaeribed flratlv in aeetlon 3,1,1, Section 3,1,2 then 
Illustrate# th# mgthod# uaed to Implement the strategy in 
order, to maintain adequate Monitor control of I/O ooera- 
t i one . 


3,1,1 General Strategy 

Five eoneepta are eonaldered in the following paragraph*. 


3, 1,1,1 Common Proceaainq 

The besje eoneeot.la that, as far a* 1* reasonable, all I/O 
proeeaalna ia performed bv eornnen potent 1 el 1 y reentrant rou- 
tine# whleh only gall. a devie# driver when some actual ohy- 
alcal deviee aetlon la needed, Thia cent has the following 
advantaoes when eonaldered in the light of the atated goal*! 

1, The routine# themaelvea, 1 1 W • ©then Monitor mo- 
dules# een be brought into memory only when re- 
quired, „9ecau*e thev use the already allocated 
Swap Buffer when they are, np extra eore ia needed 
for them. Moreover the driver#, being devoted 
solely to ereeasaes needed to control the deviee 
hardware they represent, ere considerably shorter 
than they might be otherwise. Their eore usage la 
therefore keot to a minimum, 

2, The potential re-entraney of the routine# allow# 
their use for aeveral requests at a time, Thua no 
restriction need be olaeed uoon the alternative 
processing a program m#y wish to perform while I/O 
ia underway, 

3, The use of common processor# forces the definition 
of , a, at andard Interface for all driver*. This aim- 
ollfles the 1 mol ament at 1 on of dev 1 ee- 1 ndeeendenee. 
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3. 1.1 . 2 Buffered Oat * 

Because of the flow aeeess rates of I/O devices. most pro- 
grams make provision for, the buffering of date being passed 
between the eomcuter and Its peripherals. Particularly if 
any form of overlapped oroeeaslng 1? to be effected. In 
general, these programs are developed with the deviees to be 
used ^ i n mind. Their puffers are# as a result, set ud to 
satisfy not only the requirements of the program hut also 
device .capabilities for handling data • singly or in blocks 
of varyina size. In one sense, however* deviee-independenee 
means that the program need consider solely Its own process- 
Ing needs for Its buffers. The Monitor instead must take 
care of the varying device date-handling attributes. 

For slmolieitv in the standard driver Interface mentioned 
earlier. the Monitor therefore treats all devices as 
bl opk-at ruetured and establishes Its own Intermediate 
buffers accordingly. In eaeh ease. the size of the bloek. 
and henee of the buffer provided. Is fixed as convenient for 
each devlee. but can vary between deviees. The drivers then 
transfer to or from these buffers as directed bv the Monitor 
and as fa? as possible this Is done in advance of^the pro- 
gram»a reaui rements. in the Interest of machine efficiency. 
Thus when s program needs Input, say. it ean ask for a fixed 
amount of data and the Monitor mav. depending uoon the dev- 
ice* be able to sat.isfy^the reouest from data already In 
core and Perhaps have more for next time. 

If should be noted, neverthel ess. that the Monitor provides 
only a single buffer for each I/O task and the oreqran mav 
be forced to wait If more data must be transferred to meet 
eny reouest. Greater machine effieienev might follow from 
double buffering. However this obviously uses more eore. 
Furthermore It a1?eadv exits to some extent (a$ Monitor 
buffer and user buffer) and so no further orovsion Is made. 
This does not of course prevent the user double-buffering 
within his orogram if he wishes to speed-up his I/O activi- 
ty. 


3_.l . 1 . 3 0 y n a mlc C ore Usage 

Although the drivers mav be relatively small as noted in 
section 3, 1,1,1, they, must still take us some core while 
thev ere jn use - likewise the internal buffers discussed In 
the previous section. Moreover the need for their presence 
Is not transient to the same extent as that for the normal 
Monitor routines* since it would be wholly unrealistic to 
force every device transfer to be associated with a second 
one from the system-device, once (a driver) is called to be- 
gin a series of I/O operations it must remain available in 
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memory until the series la complete - and Its internal 
buffer with it. On tha other hand# It la equally advisable 
that neither the driver nor buffer ahould oeeuey core until 
they are actually needed or aoaln after they have served 
their puroosel that core might be out to tone other use. 

It la thus for eases like these that the dynamic allocation 
and release of buffer soaqe within free eore as described In 
section, 2.4.2# Is mainly provided* In addition certain of 
tha Monitor's I/O oroeeaeino modules to be discussed In see* 
tlon 3,2# primarily exist in order to allow the user to con- 
trol the usage of eore in this wav. 

The fact that a driver is loaded only whan required and not 
with the program also furthers the cause of device Indepen- 
dence, In that the user can, under eertaln c i reumst anees# 
rectify errors In devlee soeel fleet ion even after a program 
has been started, (see section 3.2.1.1) 


3. 1.1. 4 I/O Levels 

In seet.ion 3, 1,1, 2 it was shown that the monitor can allow a 
yser program to request Its data transfers In quantities su- 
ited to Its own needs rather than to meet devlee eharae* 
terlotleo. The Monitor also enables the program to Indicate 
how the move is to be made and whether any checking Is to be 
carried out in the oroeess. It Is at this# the READ-WRITE 
level (,see section 3,2,2), that most users will In faet wish 
to perform their I/O operation in the normal wav. 

For some applications however# the time taken both to move 
the data across two buffers and to accomplish the various 
proeejsing forms mav be prohibitive. Two other levels are 
therefore provided. At the very basic# or ,TRan level (see 
sect 1 on . 3,2* 1 , ) # the user sacrifices device-i ndeoendence but 
then virtually has dlreet access to a drive* to transfer da- 
te between his program area and the device without the Moni- 
tor's intermediate buffering. At the see end# or BLOCK level 
(see aection 3.2.3)# the user Is given access to the 
Monitor's buffer# Instead of supplying his own. In order to 
carry out random-access I/O. At both levels, though, the 
user program must perform its own dat a-oroeess 1 ng. 
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3. 1 . 1 . 5 Device Assignment 

A* will be shown In section 3. 1.2.1* the usee can designate 
the devlee to service paeh dataset within a Link-block in 
the program. similarly# if the device 1 $ file-structured# 
as described In chapter 4* ha mav also name the file ha 
wishes to aeeess in a procram File-block (sea saetlon 
4.3.1). On, the other hand# ha n«v not know this Information 
whan the orooram is written as perhaps in the ease of a gen- 
eral eopy program, Pven In the former situation, there mav 
be occasions whan t he . or 1 al pel erogre" soael f 1 eat 1 ions must 
be ehanaed (a line-printer is temoorerilv out of action# for 
example)# so a listing is to be outout to a disk file or 
again# because a particular data-eegulsltlpn rate was too 
high for on-line processing# the data was dumned on the disk 
end now the proeessf n ® Program must access the letter rather 
than the date-eoui si t ion levies. The Monitor therefore pro- 
vides, two methods bv whleh the user mav seeelfy the device 
(or file) at program run-time* 

1. He can enter the run-time specification via the 
console ASSIGN commend described in section 6,4. 
This, will then over-ride the eor respond! ng Program 
detai 1 • 

2. He ean structure the program to accept a command 
strlno and use the Command String Interpreter to 
pf,rform the neee^serv decoding end.set-uo (see sec- 
tion 5.4). This, method is espeeiallv appropriate 
if. separate runs of the same loaded program use 
different devices end files# e.o. As In an Assem- 
bler. 


3.1,2 I/O Contr ols 

In orde* to maintain the concept of deviee-indegendenee# the 
user Is encouraged to orogrsm I/O in terms of the logical 
purpose served within the, program bv the data transferred 
rathe* than of the ohysieel device Involved. Thus# In the 
Programmer's Handbook# all I/O functions are shown to be 
performed, not uoon 9 device but upon a "dataset" • defined 
as "a logical collection of data which is treated as an an- 
titv bv the orogram" (in other words# all the data which Is 
processed In the same manner within the program). In orac- 
ties# dataset and devlee.may in fact mean the. same thing. 
In a OECtape eooy program, for Instance# the tana being co- 
pied end the one beina oroduced eaeh constitute a dataset. 
On the other hand# a datafet may be less than^ell the data a 
device can supply* e.g,# It may be Just one of several files 
stored on the same DECtape (see chapter 4), At times* It 
may even streteh across several devices* as a tyoleal exam- 
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plii all the obJeet modules being linked into on® lead wo* 
dule* whatavtr their souree# form a stadia dataset to the 
linking program* LINK-ll, Two points must however be noted! 

1. A dataset can only support one source or desttna* 
tton at a ttma. Thus although two disk files being 
merged bv a sort program both form Its Input* each 
must be associated with a different dataset. 

2, It Is conceivable that when a dataset Is aetuallv 
associated with a bi*dl reet tonal devtee • the eon* 
sole typewriter perhaps* *.the user might wish to 
use the dataset also bi-directional 1v. By defini- 
tion this cannot bet logically Input emd eutout ara 
processed differently. Nevertheless* usaoe of the 
sgme dataset ljnWage within the program (see see* 
tton 3.1.2. 1) is not completely gut of the question 
if this Produces economies* Provided that sueh us* 
age Is Seouentlal* l.e. the dataset can be 
rer 1 ml 1 1 al i ted for output as long as It is released 
from any commitment to input. 

Seetlqns 3.1, 2,1 to 3.1.2.3 following describe the channels 
set uo bv the user and the Monitor to control the operations 
upon eaeh dataset. Section 3.1,4 diseucco* the mechanism bv 
which the drivers servicing the datasets are managed. 


3.1. 2.1 User Link Block 


For each dataset to be usgd .concurrent 1 v* the user program 
provides a data*b1oek of potentially variable lenoth known 
as a Llgk-bloek* gs Illustrated In figure 3*1. This Is des- 
cribed In detail in the Programmers Handbook. Briefly* its 
purpose is to enable the user to Identify the dataset both 
Internallv - bv passing its address as a call parameter for 
each reouest for an I/O service - and externally by a logi- 
cal game which ean.be used to associate the data-set with a 
physical device assigned to it at run-time (see next sec- 
tion). The Link-block also allows him to specify the device 
within ,the program or may provide soaee for. additional in- 
formation if ha Intends to obtain such specification through 
a command string (see seetlon 5,4), Finally he ean indicate 
what aetlgn the Monitor shoyld take If an I/O raouast esnnot 
be setlslfed through laek of free core for the driver or 
buffers needed. 
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3. 1 .2 .2 De vi ce Assig nment Tabic 

In order to give the user ee mueh flexibility as possible* 
Device/Flle epee 1 f 1 eet ion by console assignment ee. noted in 
section 3. 1.1.5 can occur at various times* even before the 
program Is loaded. The Monitor must therefore store the da* 
ta from each ASSIGN entry. For this Purpose*. a Device As- ^ 

slgnment Table (DAT) Is set up as retired within the *«on1- ^ 

tor area (see tbe ASSIGN command processor in section ; 

6.4.10) and Its. entries are then cheeked whenever the pro- *,v \\ 

gram under execution calls for dateset Initialisation (see ^ ' 

section 3.1.2, 1). When in existence* the table's start ad- 7 
dress. is stored In the Beginning of Assignment Table (BAT) \ 
word in the SVT (see section 2,1,1). 

As illustrated in flours 3-2* the table Itself may consist 
of separate segments as follows* due to the varying memory 
loadings at the times when asslanments are entered! 

1, Prior to program loading - the permanently resident 
Monitor Is virtually alone in core. The table mav 
therefore begin immediately above its end. Entries 
made at this time need not as a result disappear 
when. the program Is removed from eore on completion 
of its .execution, Thu? the user Is given the fa- 
cility of assignments which affect not Just one 
program but perhaps several operating together In a 
suite. The fact that for this ease the table 
starts where the Monitor Buffer Allocation Table 
ends Is used to oroteet these entries*. If this Js 
the only OAT segment* the EQm stored in the 3VT is 
set at its end (see eeetlen 2,1,1). 

2, After program loading but before program execution 
• it is possible that the normally resident Mgm^tor 
mav be extended by routines loaded for the Program -> 
duration. DAT entries here must come after thesef 
rout i nea . end* since the routines must later be re- J 
moved with the program* the entries also go, (if 
in fact no routines ere loaded* a word Is left 
between the Buffer Table and DAT start as an indi- 
cator), EOM Is adjusted also to the end of this 
segment , 

3, After the start of program execution - the area 
from EOM Is under the control of the Monitor buffer 
management routines described in. section 2.4,2 and 
some buffers may already be allocated to other our- 
eoses. Thus further DAT entries must also use 
buffers similarly obtained. For simplicity In the 
ASSIGN command processor* eaeh entry uses a new 
buffer even though this wastes so see. Assignment 
at this time Is therefore not recommended except as 
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4 mtipii of rectifying an erron detected during da- 
taset ini 1 1 el 1 zet Ion. (sen aeetlon 3, 9.1,1). Thane 
ana other reasons toot 

a. The buffer used by the entry eannot be released 
until the_program terminates - this could lock 
out the buffer areas from free eore even theuoh 
they are no longer In use. 

b. fa part of the normal elean-up carried out dur- 
Ino the orocasslng of the console RESIN command 
(sea section 6.4)* all free eore buffers are 
released for a fresh start. 

e. ynlesa the assignment is made before dataset 
Initialisation It will have no effect. 


The segments are connected by a two word entrv at the end of 
eaeh. The first word is set to -l to indicate that another 
segment follows* the second then shows the start address of 
that segment (l) t (This linkage is also used to delete en 
entry amended bv a later assignment). The end of the com* 
plete table Is denoted by 0 in the first word. 


The format of each entrv is given in figure 3*3. The signi- 
ficance of the principal items is as follewsi 

1. Looleal name • corresponds to the same Item In the 
user Link-bloek discussed in the previous section 
and thus provides the connecting link between the 
entrv and the dateset it affeete, 

2. Device name • shows the devlee to be associated 
with the dataset. 

3, Device unit • stores relevant identification if the 
deviee controls several units. 

4, Number of words to follow - allows restriction of 
the entry, size to the minimum needed for any 
f i 1e - speei f Ication entered* e,g.» If File-name on- 
ly* this will be 2. 


I. The seeond link word mav be 0. This indicates the table 
end If a console BEGIN removes assignments in buffers (see 
Section 6 • 4 a 5 ) . 
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The remaining Items s.upolv data otherwise given In the u§er[ 
Fl 1 e-bl eek (see section 4.3.1), The 1 ool cal riame* of course ^ 
must be supplied, The rest may be validly omitted es shown 
In auction 6,4,10, (If their aoaee must be Included)# the 
appropriate table-slots are than set to 2 e.g.* If only UIC 
1$ entered* Item 4 must be set to 4t File-name and Extension 
will be left blank. 


3,1. 2. 3 Dataset Pete Bloek 

The Monitor has no knowledge of the preoram‘8 T/0 require- 
ments, until the Program Itself Identifies these by request- 
ing Initial list ion of the datasets to be used. Hence* as 
Stated in. the Programmer’s Handbook* .INIT must be the first 
function eelled In eaeh ease. In response to sueh call* the? 

Monitor seta gp Its own control block for the dataset w1th1n\ 
a 16-word buffer unit claimed from free core and stores its , (><-'>*' 

address In tha link-word of the user Link-bloek (see section 
3.1.2. 1), This block known as the Dataset Data Block (DDB)» 
is used .thereafter as, the. means bv which different Monitor 
routines oass Informat Ion . to eaeh other and also eommunleate 
with the driver, servieinq the dataset. It Is retained In 
memorv until the program releases the dataset from further 
I/O eetlon (see section 3.2.1. 3)| Its buffer space Is then 
returned to free core. 

The format of the DDB.Ie illustrated in figure 3-4, The 
purpose of the items is as follows! 

1, Monitor link.- enables the Monitor to maintain a 
control chain of the DDB's current 1 y estebl 1 shed* 
as Illustrated In floure 3-5. The chain orlalnates 
at. a DOB Chain Origin (DCO) word in the SVT (see 
section 2,1,1). 

2, Q link « Is used to chain the DDB's for datasets 
welting upon the services of the same device as 
described in the next section, 

3, Priority level.- stores the level at which a aueued 
eall to the driver Is made. 


\ . 

4, Orjver routine Index - Is normally 2 unless a 
driver call is. queued! a pointer to the driver rou- 
tine required is then saved hare Instead. 

5, Driver address • contains the address from which 
thp driver associated with the dataset Is loaded. 
This also serves to identify the drlvep when com- 
pared with entries In the DDL (see section 2,1,3), 
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6. Byey flag • Is set bv the EMT Handler (see seetlon 
2.2,1) to the Address of the orogram I/O call whan 
aeeeoted. This forces any subseouant call to wait 
yntll the current reauest has befn satisfied • whan 
It Is resat to 0. The address of this word Is the 
one stored In the user Link-block as the DOB con- 
nection to Its dataset. 

7. User line address - In general Is used to save the 
second parameter passed by most I/O ealls (normally 
the address of a date-block in the orogram, a.g.r 
Line Buffer in .READ/, WRITE, TRAM-bloek in .Tran, 
ate. 

S, Device block • points to the deviee address of a 
block on a bulk storage medium. 

9. Buffer address - shows the. start of a memory ares 
for transfer • normally this is an Internal Monitor 
buffer! thus this word Is also used as an indica- 
tion of the current assignment of sueh buffer 
(cleared to * if none). 

IP. Word eount - gives the number of words to be trans- 
ferred bv the devlee as a two's complement value. 

11, Status - Is used to dlreet th* driver on the type 
of transfer reoulred* allows the driver to return 
error indicators and stores other control Informa- 
tion on a blt-basla as shown In flours 3-6. 

12. Completion return - shows the address at which a 
calling rout 1 ne. regul res the driver to return when 
a reguested service has been satisfied, 

13, Driver word eount - allows th e driver to Indicate 
(aoain as two's complement) how manv words are not 
transferred because an end of data point Is re- 
ached. This word is also used to store a variable 
oointar to the next byte to be processed, In the 
Internal Monitor buffer. (N 0 devlee aetlon ean be 
underway at this time). 

14. Byte count - Is used during .REAP/.wolTE processing 
to control bvtes passed between the erooram line 
and the internal Monitor buffer. 

IB. Checksum - is mainly provided for the orocesslmg of 
formatted binary data (see seetlon 3. 2. 2.2). 

16. DAT pointer - is set during dataset Initialization 
(see seetlon 3.2. 1.1) to the address of an entry In 
the Devlee Assignment Table cor respond! ng to the 
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dataset# If sueh exists (see previous section), 

17 . FI8 link - connects the DOB to a 16-word buffer ex- 
tension whenever f 1 1 e-st ruetured operations are 
underway on the dataset as described in section 
4.3,2, It Is set to 0 otherwise. 


3, 1.2, 4 Orlyer Management (RMQM 3 Cent 1 n u e d ) 

It was noted in section 3.1.1.1, that, the device driver 
should present a standard. interface. to the eonmon I/O or©« 
eesslng routines of the Monitor, This interface will be 
discussed in section 3.3. The routines In their turn# 
however# must also use standard calling seauences when they 
require the driver's services. This section will describe 
these. 


Monitor Calls to the Driver! 

Initially It is the calling routine's resoonsi bi 1 i tv to en- 
sure that the relevant data to control the dev 1 ee . ooerat Ions 
Is yet Into the DOB described In the last section# l.e,# 
Device B1 oek# . Buf f er Address# Word Count# Status# Completion 
Return and 0 In the Driver Word Count, The routine also 
sets realsters as follows! 

R0 ■ Address of the DDb (Pusy Flag) 

R1 ■ Index into the Driver Interface 
Table# (see Section 3.3.1). 

This Index points to a bvte 
containing an offset from the driver ^ 
sta r$ to the beginning of the routine c ' 
orovldlno the service required# e,q,» 

Open Is shown by 7# Transfer by 10# ete. 

The contents of the other Registers are Immaterial* however? 
drivers do not save them. It Is thus. up to the routine to ^ 
do this If sueh contents are reoulred after return. 

The routines themselves do not actually call the driver. 
Normally a single device controller ean only support one oo-? 
eratlon at a time# even_though it may have feveral units, \ 
Thus the driver Itself need contain only serially reusable 
code. However it must then be protected against recall 
while at 11.1 performino anv service. The Monitor therefore 
provides two sub-routines to control the yse of drivers and 
since they must be ealled for every device action thev are 
part of the resident section. Basically these subroutines 
provide for queued requests for a driver's services In order 
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that a calling program wav oreeeed with alternative oroeess- 
1 ng as far aa possible. 

The subroutines are S.CDB which cheeks the need for a aueue 
and seta It up when neeeasary and S.GDQ which ensures that 
the driver la given Joba from the aueue as It completes eaeh 
one. Like the other resident sub-routines, thev are ee- 
eeased through vector locations (50 and 52). respectively, 
Since, as shown abgve, arguments are passed in Registers or 
the DOB, their calling aeauenees are aimplei 

MOV 0*50, -(SPJ t CALL S.CDBC52 FOR S.CDQ) 

JSR pe,*(SP)+ 


Driver Oueuelngi 

Thua a routine needlno a driver operation first calls 8, COB, 
The processing of such ealla la Illustrated dl aoremmat 1 cal 1 v 
at flours 3-7. It Involves the following steo'as 

1, Extract the relevant driver start address from the 
DDB Identified bv R0 and. check Its first word - a 
busy flao In the standard interface table, 

2, Jf this Is 0, showing the driver to he currently 
Idle, store R0 In the busy flag to claim the driver 
fpr the reoueeted service and to provide the driver 
with a link to the DDB concerned. 

3. Clear the driver routine index save location In the 
ODB to Indicate direct entry end use R1 to build 
the address of the driver service routine required. 
Jump to this addreaa, thus leaving the saved return 
address from the S.CDB eall on too. of the stack as 
the driver's means of Immediate exit to the calling 
rout ine(l) . 

4. If the driver is already busy as shown bv a non-? 
flag at step 1, eheek the 0»11nk.1n the DDB ad- 
dressed bv the content. of the flag, j.e.» .the one 
currently being serviced bv the driver (from step 
2). If this Is 0, no aueue vet exlstsi start one 


1, As, will be shown in Section 3.3, all drivers use the 1n- 
terruot system. . In general, a eall to a driver merelv re- 
sults In the initiation of the herdware action end on exit 
to await the first interrupt, denee the return fro" S.CDB 
is not the seme as Completion Return stored In the DDB, 
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by storing the address. of the OOP for the new re- 
quest from R0 .In this Q-link and a ava R.1 and the 
priority level of this request In Its own DOB, 
(•at figure 3-8). 

S, If a auaua already exists* traee It via the 0-11nks 
In, aaeh OOP and insert tha new request In Its so- 
oropriate olace althar as tha last at its priority 
laval or at tha, and (shown by a 0 link)* whichever 
eo*es first, Exit bv normal sub-routine return. 

On return*, tha eallino routine is of eouraa unaware of tha 
feet that tha driver may still not be ealled, alnee the ex» 
Its. at steef 3 or 5 ere the same. However at this t1*e* the 
difference Is Immaterial* tha routine can. do nethlno but wa- 
it In either ease until, tha driver satisfies ita request. 
In oaneral* the user program is recalled to continue its oo- 
orations* until* as the result of an interrupt* the driver 
recalls the Monitor routlne.vie the Comolation Return In the 
DOB. It does this with Registers at the interrupt saved on 
the stack and R0 again sat to tha DOB address. Its busy 
flao however* is not cleared - and nothino has vet been done 
about further requests possibly still welting In a oueue. 


Driver Daouauelnql 

It is therefore tha Monitor routine's resoonajbi 1 i ty to en- 
sure that tha driver is. started upon its next task If any, 
Per this a eal 1 to 8. COO Is used, normally, oreeeded by a 
save of, the contents of R0 slnee the routine needs the DOB 
address for. Its later processing end this een be lost In the 
possible driver recall. The operation of S.COQ Is also out- 
lined in flours 3-7 and consists of the following ateest 

1, Extract the driver address from the ODP olvan bv R& 
and elear Its flao • this will be reset If another 
task Is in line at stee 4, 

2, Cheek the 0-11nk In the OOP and if this is 0* exit. 

3, Otherwise reset R0 to the Q-link content and dear 
the Q-Ilnk, 

4, Using the new R0 value (oointlng to the 0DR to be 
serviced within the already established orlorltv 
seaugnee)* reset Rl, to show the new driver service 
reauired from the previously saved value and return 
to S.C08 at step 2 to restart the driver. 

Again the saved return address* this time from the 
8.CDQ eall* enables the driver to exit to the Moni- 
tor routine at the aoprooriate point from which It 
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can restore R0 and continue its service to the 
user, Whan it completes# tha Register contanta 
saved bv tha driver# aa noted above# are peatoned 
as oapt of the normal program reeall process. (see 
fioure 3-9). 


Comments I 

It ahould b« mentioned that both S.CDB end S.CDQ adjust orl- 
oMty levels. Normally both operate at the call lavall 
henee 8-CDQ particularly beaine bv dropping down from tha 
device level since the Monitor routine la reealled from in- 
terruot. However both perform flag eheeks and for safety, 
thev raise the level to 7 temporarily while they do so • 
posslbjv an unnecessary feature In the currant atatg of DOS 
development, as a elmgle-user single-teak svstemi It Is in- 
eluded nevertheless aoainst possible future modifications. 
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3.2 I/O Processing 


The purpose of this seetlpn Is to examine esch of the eommon 
I/O processing routines In detail within the context of the 
overall phllofoohv dlaeuesed in section 3.1. To Illustrate 
the general effect upon the svstam, the routines called bv a 
user programming basleallv at the .TRAn level will be han- 
died as an Introduction In section 3.2,1, Section 3,2,2 
will then expand upon the basic pattern by deaerlhlnq the 
routines called for normal processing at the .READ/, WRITE 
level. The remaining general I/O modules for random access 
and seeelal operations are covered in sections 3,3 & 3,4, 

It should be noted that all the module*, being potentially 
non-resident (the ,BEAD/,WRITF processor currently exeeot- 
ed), use techniques diseusaed In section 2,3 and as I/O mo- 
dules . 1 neoroorate concepts shown In section 3.1 (particular- 
ly driver calling Illustrated In section 3, 1,2,4), Henee 
eross-refereneing to these sections by the reader will be 
assumed where not given. 

All the routines may take adventage of register contents 
passed bv the EMT handler as follows! 

R0 ■ Address of the DOB for the dataset 
to be serviced 

Rl ■ Stack address of the first call 

parameter, l.e,, the address of the 
user . Link-block, 

R2 ■ Program eall address. 

R3 ■ Processor Status Register address 
(or -2) 


3,2.1 Basie I/O Processing 


At the basic level of I/O, the user merely requires the Mon- 
itor to control the operations of a dev ice-dr 4 ver to oerform 
direct transfers of data between his Program area and the 
device. The program itself carries put all the processing 
of the data required, This Is accomplished bv e call to the 
, TRAN routine. However, before any I/O operation can be ef- 
fected, the program must notify the Monitor of its require- 
ments bv callinq ,INIT to Initialise the appropriate dataset^) 
and make the necessary devlee driver available in memory,/ 
Between transfer reouests, the program may eall .WAIT to en- i 
sure the transfer has been completed before proceeding. 
When all transfers have been done, the driver and dataset 
linkaae are removed bv a .RL3F eall. The resulting orogrem 
outllna Is given under .TRAN in the Programmer’s Handbook, 
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The .WAIT processor 1* Included In the Emt headier end wee 
discussed in section 2.2.1. The other three routines ere 
described In the following paragraphs. 


3 • 2 • 1 . 1 Oeteeet Ini 1 1 el 1 set 1 on (INR ) 

As noted above, the or 1 nc 1 pal f unet 1 one of the .INIT proces- 
sor ere to ensufe thet the driver for the deviee reaulred bv 
e user dataset is loaded Into memory if neeessary and to 
connect, It to e program Link-block definlnq the deteset vis 
e DDB within the Monitor. It also sets the devlee-lnterrupt 
vectors accordingly. 


Cel 1 1 no Seouencet 

The prooram celling sequence Is as foMowsl 

MOV SLNKBLK.-(SP) »PA3S LINK-BLOCK ADDRESS 
CMJ fi »CALL .INIT 


Proeesslnoi 

The sequence of operations carried out by the .INIT oroees- 
sor Is out 1 1 ned bel ow. and Is further illustrated in figure 
3-10. The state of memory on eomoletlon Is given In figure 
3-11. 

1, Collect the Llnk-bloek address end dear it from 
the staek bv moving the saved user Registers down. 
Set a pointer to the start of the Monitor DDB chain 
as stored In the SVT (see section 2.1,1) 

2, Jf the link-word In the Llnk-bloek Is non-0, eheek 
If its content points to.a valid DDF bv searching 
the DDB eheln and ignore If not, 

3, Otherwise this eould be a re-lnlt. Release any 
valid Internallv established buffers linked to the 
DDB. e. g. , data buffer. Pile Information Block, 
Blt-mao (see chapter 4), etc. Set up to use the 
sane DDS again. 

4, If.no DOB is. currently established, elalm a buffer 
unit from free eore, if available vie S.GTB, and 
link It to the Monitor eheln. 

3. Clear the DDB completely end store Its address in 
user link. 



D0S3.RND 


PAGEJ-17 


6. Using the dataset Logical Memo from the user 
Link*b1oek# search the Device Assignment Table for 
a valid entry fsee section 3. 1.4. 2). If found# ex* 
t,r#et the name of any driver soeeified and store a 
oointer to the entry In the DOB. 

7. Otherwise get the driver name from the L1nk*bloek. 
when none is alven# e«11 ooarator action (error 
message A003 - see shooter 7), If e return then 
oeeurs# a new console aealanment may have been 
made# so return to steo 6 end cheek again, 

8. Search, the DDL (see section 2.1.3) for the driver 
fpeeified (1). Call ooerator action as in steo 7 
for a driver name which dees not exist. Otherwise 
oo to step IP unless the DDL shows the driver to be 
already in memory, 

9. From a switch set in Its Interface Table (see see* 
tlen 3.1.1)# verify the ability of a leaded driver 
to supoort more than one dataset at a time and omit 
the load process If satisfactory. Otherwise search 
the Monitor chain to ensure that no other DOB Is 
associated with the same driver# calling for a new 
assignment as In steo 7 if neeessary. 

IP. Using the DDL information on the driver's location 
gn. the svstem device# elalm a buffer of driver site 
from free eore. If none Is available for this# or 
for the OOP In steo 6# take anv user error exit 
fupplied In the Link-bloek or, failing this# call a 
fatal error (FP07). 

11. Prepare the DDR for a read*t renaf er into the els* 
imed, buffer, from the. avstem«dev 1 ee based uoon the 
DDL information and using the same routine as 9AM 
(see section 2.3.4) for handling transfer eomple* 
tlon. Also set the DDR busy flag. 

12. Save significant Register contents and via S.CDB# 
eall the System«*deviee driver. _Cal1 *WAIT until 
done (as Indicated bv clearance of the PDB busv 
flag In the SAM seouenee). 


1. .The driver for a console A9R-33 Teletype considers two 
devices KB and PT with different entry Points. The DDL 
however only shows KB » hence the search for PT looks for 
this single entry. 

The relevant entry oojnt for devlee PT is eomouted from the 
entry ooint of device KB since the same driver contains 
both. 
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13, On. comol at ion# set the DDL to shew the core loca- 
tion of the driver end using Information. f ran the 
driver Interface table aet uo the devlee Interruot 
vectors (except for console typewriter - already 
connected to the reaident Keyboard Listener (aee 
section 6,3)) 

14, Clear the buffer address from the ODB to show that 
no data buffer has vat been attached and reset Into 
the DDR "Driver Address”. Collect and store the 
devlee unit from the DAT or user L1nk«bleek as ap- 
propriate. 

15, Taka the System Exit to release the Swao Buffer If 
neeessarv* restore orooram Registers saved bv the 
EMT Handler and return. 


Commentsi 

The r.e-<§nt raney of the .IMIT processor merits further dis- 
cussion. The Monitor S.GTB routine is called to obtain the 
buffers for the DD 8 snd driver and this does not protect It- 
self against interrupt (see section 2,4,2). As a result. 
•ZNIT is set to be not re-entrant when in the Swap Buffer 
(see .section 2.3,1). .However the protection does not pre- 
vent re-entry If .INIT js.made resident. This is no Problem 
under DOS eurrentlv.sinee only single-tasking Is permitted 
and tbe user program Is not recalled (implied by step 12 ), 
Nevertheless care. Is neeessarv following anv Monitor modifi- 
cation for real-time uaage. 


3. 2. 1.2 Beale Transfers (TRA) 

The .TRAN Monitor call enables the user to perform direct 
transfers, between 9 devlee and a memorv area without Inter- 
mediate Monitor buffering. The site of the transfer Is lim- 
ited only, bv the caoaelty of a single word-count (65K), The 
Moni tor, however# exercises its normal control over the dev- 
ice# .i.e.# allowing the transfer only if the driver Is cur- 
rently idle and gueueing the reguest otherwise. Tt must be 
noted .however that .TRAN allows absolute .access to 
bulk-storage devices. Indiscriminate use in this resoeet 
can corrupt the f 1 1 e-at ructur i ng of such devices (see 
chapter 4), 


Calling Seouencei 

The , TR an processor regulres the Program to sueiplv control 
parameters for the transfer bv means of a TRAN-bloek which 
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Is Illustrated for reference it figure 3*12, Briefly Its 
purpose la to allow. the user to detail the devlee and memory 
address# size and direction of the transfer and to allow the 
Monitor to return status Information (for further detail# 
see the Programmer • s Handbook), The address of the block Is 
passed as an argument In the call seouance as follows! 

MOV «TRABLK,-($P) fPASS TRAM-BLOCK ADDRESS 
MOV *LNK8LK,*(SP) »IDEnTIFY DaTaSET 
EMT 10 »CALL .TRAN 


proeeaai not 

The sequence for .TRAN oroeesslng Is relatively stralohtfor- 
ward so no dlaorem Is needed. Basically the stars are as 
shown below! 

1. Extract the driver address. from the ODB .and store 
the TRAN-bloek address in the user Line Address 
word of the DDB, Clear the cell arguments from the 
staek bv moving saved program Registers down. 

2. Move the transfer control parameters from the 
TRAN-bloek into the DDB (with wiprd-eount negated). 
At the same time cheek for Invalid call as follows! 

a. Zero word-eount 

b. Illegal function for deviee (e.a,# read from 
1 ine-orinter) 

e. Invalid function 

For (a) and (?) ignore eall by returning 
error status in TRAN-block and exit. For 
(b) call fatal error (F003) 

3. SeJ the ODB Completion Return# RP and R1 as re* 
oujred for e driver transfer call and go to 8, COB, 
While waiting# restore saved proeram Registers and 
reeal 1 the prooram. 

4. When recalled by the driver# call 3.CD9 to dpgueue 
it. 

s. Return a flgo to. the user In the. T R AN*bloek for 
transfer of parity errors and simi 1 arlyany Ineom- 
Plate Word-Count (a* e positive value) If either of 
these apoears in the DDB. 

8, Clear the DDP Busy Flan and Buffer Address (not a 
Monitor buffer). Take the System Exit to return to 
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the calling Program. 


Comment*! 

,TRAN is reentrant *t all times# reosrdleas of the eenmanen* 
ev of it* core-residence, However because of its internedi- 
ate returs to the user *t eteo 3, a following ,WAIT la ad- 
vised feefore either the Tran-bloek op the date area 4a pro- 
cessed further* 


3*2.1. 3 Dataset Release (RLS) 


Tbe .RLSE. processor basieal 1 y. performs the inverse function 
of *INTT» it releases the driver provided that no other da- 
taset Is still usino it and that It. is not permanently real- 
dfnt. It then returns the DDB buffer to free core and un- 
links^the user Link-bloek. Henee from this point# the Moni- 
tor forgets the existence of the dataset until eerhaos a 
eeeond .IMIT restores it, .RLSE has no mechanism for han- 
dling still-ooen bulk-storaoe files! however it does Perform 
basic .CLOSE operations on simpler devices* 


Cal 1 ing sequence! 

• RISE is eel led bvi 

MOV SLNK0LK.-CSP) »PASS LNK-BlOCK ADDR 
EMT 7 iCALL ,PL9E 


Processing! 

The sequence of operations for RLS is illustrated in figure 
3-12, The baaie steps are! 

t, Seve the Link-bloek address and remove it from 
stack. Extract the driver address from the OOP, 

2, Check whether a Monitor buffer is still attached to 

the DOS indicating that no ,CL0SP has been per- 
formed* _6o to steo S if not. Call fatal error 
(FP05) if a flag in the driver interface table (see 
ffetion 3.3,1) shows its device to be 

f i 1 e-st ruetured) otherwise, 

3, Set the DDR Completion Return in ease deviee action 
is needed# (usino the saved returned address from e 
JSR call to eause execution of an embedded short 
form of the SAM driver completion seauenee • see 
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section 2,3,4). 

4, Determine whether the last operation on the dataset 
was . out out and than whether any valid data still 
remains In tha Monitor buffer (based uoon tha valua 
of tha variable pointer stored In the DOB Driver 
Word Count)* If so, save tha DDR address and Its 
®u|y Hag content and call the driver to anotv the 
buffer via 3.CDB. Call .WAIT until finished, 

5, Release tha Monitor buffer# If appropriate, to free 
eore via 8. RUB, .Using the site shown as the driver 
standard In its interface table, 

6, Search tha DDL for the entry containing the same 
driver address as that In the DDR, 

7, When found, traee the Monitor DDB ehaln for possl- 
Me other users of the same driver faoain allowing 
for the duel nature of the console ARR-33 driver • 
see footnotes in section 3,2,11). If anv, lanore 
step 8. 

8, When this datase; is the sole user, and the DDL en- 
trv shows that Ita driver Is not permanently resi- 
dent, reset the device Interrupt vectors to trap on 
ernor, deer the_dr1yer‘s core address In the DDL 
and return the buffer it occupies to free eore. 

9, Unlink the DOB_from the Monitor ehalm and release 
Its buffer to free eore. Take a normal System Exit 
to return to the calling program. 


Comments t 

Slnee .RLSE uses S,RL R with similar vul nerabl 1 1 tv to that of 
3.GT8, the remarks In the lest paragraph of section 3. 2. 1,1 
also apalv here. 
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3.2.2 Normal 1/0 Processing 


As discussed jn section 3.1.1* the uier who dots not wish to 
consider Physical devices and reoulres rore service from the 
Monitor performs seauentlal I/O operations at the REAO/WRITE 
level. In response to .READ or .WRITE calls* the Monitor 
transfers data* formatted to an extent specified by the 
user* between a. user line of devl $e*i ndependent size and its 
own Internal buffer which Is filled or emptied by the 
deviee-driver 9 s neeesaarv. Prior to $he transfers* e eall 
to .OPEN esteblishes the neeesaarv conditions for operations 
with any device, similarly .CLOSE ensures proper eleen«uo 
after the transfers have been completed In all eases. The 
following paragraphs examine these functions in more detail. 


3.2.2 .J D ataset Open ( 0 P N ) 

In section 3, 2, 1.1 it was. shown that the .INIT call merely 
enables the user to associate the dataset with the driver to 
service It. The .OPEN eall is provided* in general* as the 
means wherebv he can crime the driver and also reaueat the) 
establ 1 shment .of the internal Monitor buffer in readiness/ 
for the transfers to eome, .In Particular* .OPEN makes filee\ 
on bul k-storace devices available for these transfers* ss 
described later in section 4.5.1. Although the eall Is not 
strictly neeesaarv except for th# latter purpose* Its use in 
all. cases Is recommended In the interest of 
devica- 1 ndeoendent programming. 


Celling Seoueneei 

The calling sequence for .OPEN reoui res, the. user to provide 
a. Flle-bloek within thf program* whieh Is Illustrated at 
figure 4-15 (slnee its principal purpose is more appropriate 
to f i 1 e-struetured operations). For the_genera! case* it 
enables the user to show the intended transfer direction and 
to supply an error exit If he wishes. The aenerel form of 
the call is as follows* 

MOV SC0DE.FILBLK.2 »SET HOW 0»EN CODE 
MOV #FILBLK,-CSP) tPASS FILE-BLOCK & ... 

MOV CLNKBLK.-CSP) t . . .LINK bLock ADDRESSES 
emt IS f call .open 
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"CODE" in this sequence In faet Identifies different forme 
of «0PfN Provided mainly again for flexibility in handling 
bul k-stprage flles(l). For the general ease* their effeet 
la aa fell ows « 

1. Open an existing file for update (QPFNij) • Imellee 
both Inout and. outeut. Slnee most simple devlcea 
(Ineluding magnetic taoe because of inherent prob- 
lems) eannot sustain both directions* this form of 
.OPEN la valid on f 1 1 e-st ruetured dev lees only. 

2. Create e new aeauentlal file (OPENn) - normally 
precedes all .WRITE operations. .It causes the set- 
ting uo Of an emotv internal . buffer. . It Generally 
nesults In a_ee11 to e non-f 1 1 e-or iented device for 
the output of some , 1 nl 1 1 al i z 1 no data aueh aa ouneh 
leader or printer form-feed. 

3, Extend an existing sequential file (OPENS) • oper- 
ates as OPENO on non»f i le-orlented devices. 

4, Open an existing file for inout (OPENl) - Is used 
aenerally before ell .READ reguests. It usually 
results in a eall to the driven for a non-file dev- 
ice to eheek Its readiness. The Internal buffer Is 
fatapllahed and py. another driver eall this buffer 
la filled In anticipation of the first .READ, 

13. Open an exlatlngeontlquous file for outeut (OPENC) 
- la. mainly provided to allow seouentlal .WRITE op- 
orations within e random-aeeees . area on a 
f 1 1 e-or 1 anted devlee. On other devices* It acts as 
OPFNO, 


Proeess 1 no» 

The general OPEN processor outline is shown at figure 3.13 
end ita affect on memory usage Is illustrated at figure 
3-14, Basically it follows tha seouence olven below* 

1, Extraet the driver address from the DDR, Save the 
eall parameters temporarily in the DOB (User Line 


1. .The codes ere allotted on the basis that pit 1 indicates 
a flle-tvoe dedicated to output and bit 2 similarly to inout 
(see also Footnote to Section 3.3.2), 
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Address & Device Slock slots) sod eleen-uo the 
stock by moving seved program Registers down. 

2, Check the validity of the code In the user 
File-block, also whether Its Implied direction Is 

* • m 

suitable for the attached driver (uslno an Indica- 
tor In Its standard interface table • see Section 
3.3.1), For failure In either ease* cell a fetal 
error (pfllt). 

3, Cheek the Doan Indicator in the DDB Status word. 
If si reedv set to show a .OPEN has been celled 
without a subsequent .CLOSE, exit to the user ore- 
oram with file error & as status or cell a fatal 
error (F012) If no address for the return is sue- 
ol 1 ed, 

4, Determine the else of the internal date-buffer 
needed by reference to a standard for the devlee 
contained in the driver interface table end claim 
the necessary space from free eore f If none is 
available, take the Llnk-bloek exit If olven or 
otherwise cell fatal error (F007). 

3. Store the start address of the buffer* In the DDR 
and dear the buffer (mainly for outdut). 

3, From appropriate Indicators In the driver interface 
table, check whether the deyiee Is f 1 1 e-st ruetured 
or Is seouentlel magnetic teoe. (Further eetlon In 
either case is described In the next paragraph) 

7. Fpr non-bulk storage devices? verify the existence 
of an OPEN routine in the driver end call it If In- 
cluded via S.CDB. Until completion, return to the 
calling proorami then use S.CDO to deoueue the 
driver. 

8. Set the Open Indicator In the DDB and check for in*" 
put .OPEN. _ If so. recall the driver to fill the 
Internal buffer, again returning to the program un- 
til done (l). Save a variable pointer to the data 


1. This. initial fill Is omitted, however, for "terminal" 
tvoe devices such as the console typewriter In order to make 
any Input eeho corresocfbd to the appropriate .REAO, 
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ip the DOB Driver Word Count. 

9. Clear the DDB Busy F! ao and take the normal System 

Exit. 

Prom $he ereeedlno oaraoraoh it earn be seen that the Initial 
eheekino end setting-up of the Internal buffer apply to all 
devlees. However the .OPEN processor must them hand over 
control to the relevant f 1 1 e-management modules to comolete 
their operations.. It therefore oreearee sn appropriate In- 
terface. . Thua for the normal file-oriented devlees (Disk 
and DECtaee)# stao 6 above la followed by! 

7, Claim a 16-word 0D8 extension puffer known as a FIB 
(see seetlon 4.3.2). Clear It and link it to the 
DDB, 

8, Hove the orlolnal eal 1 argumente to temporary ato- 
raoa In the laet two worde of the FIB and store the 
Open type code also in the FIB. .Save a OECtaoe in- 
dicator in the ODB using driver interface table in- 
format 1 on, 

9, Set Registers aporoor 1 atel v as follows! 

RB ■ Address of the DDb 
R i ■ Address of. the eal! oarametera 
as stored in the FIB 
R2 ■ Address of the Oopn tyoe code 
in the user File-bloek 
R4 * Address of the FIB. 

10. Prepare the appropriate EMT call to the 
file-management OPEN routine reaulred and eal 1 It 
(see seetlon 4.5.1), (1) 

Similarly for sequential magnet letaoe, the following steps 
oeeur i 


1, Slnee this mav require Swap Buffer release the cal! can- 
not be made from within the Swap Buffer, Hence depending 
upon the current location of the .OPEN processor as shown by 
Its Usage Count (see section 2,3.4), the following sequence 
la stored In the ODB (Byte Count & Checksum) - and Is exe- 
cuted from there! 

DECB MSB, IRLSE SWAP BUFFER IF NEC. 

EMT 43 tCALL POP (44 FOR FCR) 
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7, Set Registers •• follows! 

RO ■ Address of the DDb 

R1 • Address of the call parameters (in DOB) 

R2 s Address of the user Flle-bloek 

R4 ■ Address of the driver 

8. Rrepere en EMT egll to the magnetic jane. OPEN rou- 

tine (see section 4,7) In seller fashion to that 

shown in stee 10 end make it. 


Comments ! 

The f i 1 e-msosaemsnt module eel led bv the sequences described 
in .the, oreeedina psrsarsohs msy be leaded into the Swap 
Buffer in th# normal wsv. Moreover env .OPEN request is 
likely to.resylt in the fyrther cell. Therefore if the gen- 
erel poytine is Itself usina the Swap Buffer It eennot be 
Classified gs re-entrant, This problem dees net exist if It 
is msde resident* of eoursel nevertheless the. ether one not* 
ed under .I^iT still remains.^ thst of cells to the unpro- 
tected S.GTB subroutine for buffer allocation, The remerks 
msde in the lest paragraph of geetion $,2,1,1 theref ore. so* 
ply else to .OPEN# especially since in Its esse Intermediste 
proarem reeel Is een be msde. 


3. 2. 2. 2 READ/WRITE Transfers ^RWM) 

Bv mesns of s .READ eell* the user requests e line of dsts 
sf ASCII characters or blncry wordsf with or without format- 
ting,".. As noted earlier* the line-site mey be set uo to 
satisfy, the requirements of thg.proorgm only* The .READ 
processor maintains an internsl buffer whieh tekes ears of 
varying, device provisions. At each ,REA0 reouest* there* 
fore* date from this buffer Is processed and transferred to 
the user. line as soeelfled bv the orogrem (e bvte at a time 
for simplicity in ell. modes). If the Internal buffer Is 
emptied* the. driver for the devlee.ls celled. to perform the 
necessary rffill end In, general* this eeeurs immediately In 
readiness for the next request* even though the grogrsm's 
needs ere currently satisfied, similarly e. .WRITE reouest 
enables the user to aupolv lines of date whieh are processed 
in like. manner end stored. Internal 1 v until a full buffer can 
be transmitted to the deviee. 


Calling Sequence! 

The proarem must supply Information on the line to be trans- 
ferred! it therefore effectively sets up s Line-block for 
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this purpose,. In. normal usage# the bloek Immediately pro* 
codes the line It controls sa a headerj this is not essen* 
tlal as, a special format (Dump) permits Its being detached# 
Tha format of the block Is fuMv described In the 
Programmer's Handbook* together with details of the differ* 
ent tvoes of processing available. For reference# it Is il- 
lustrated, at figure 3*15, Briefly# It allows the user to 
pass maximum and actual line-sizes and speeifv the type of 
processing reoulred and enables the .READ/, WRITE processor 
to return status dpta whan tha transfer la, complete. The 
address of tha bloek is given as a parameter in the ealllno 
sequence as follows! 

MOV «LINE.*(SP) f PASS LIME 

MOV #INKBLK.-CSP> ! ...LINK-BLOCK ADDRESSES 

EMT 2 fC ALL .WRITE (4 FOR .READ) 

Proeessi not 

Many of the operations needed to service either ,READ or 
.WRITE are eommon to both. Furthermore concurrent inout and 
cutout .are highly likely. A single proeesagr therefore han- 
dles both requests with its one entry point stored In the 
two eorraspondl ng slots In the MRT, The mainstream of this 
processor performs the common, operation! it eslla subsidiary 
routines to provide. the functions unique to .READ or .WRITE. 
To do this and avoid the need for eheeklng whieh routine la 
to be eplled everv time# a eo-routlnlng technique Is used as 
fol lows! 

1. The function as shown by the EWT code (2 ■ .WRITE# 

4 ■ .READ) upon Initial entry Cor the function ad- 

lusted by 4 qn recall from. driver action to allow 
for variations at this time) Is the basis *or the 
computation iqf an appropriate address in a branch 
table which is then called bv a normal J3R PC#XXXx, 
(This provides the cheek for the unique routine re- 
oul red) • 

2. When the unloue routine needs to return to the ma- 
instream# it does so bv JSR PC#*fSP)e,. This per- 
forms as RTS PC in that Broeoaslng continues from 
the address saved on the stack by. the original JSR 
eall and removes the address from the stack. 
However it Is replaced bv the address at which uni- 
que operations are to be resumed. 

3. Similarly the mainstream effects the resumption bv 
JSR PC,a(SP)+ and appropriate branches in both the 
mainstream and unique routines eomol^t# any looping 
neeessarv. Thus after the first eheek# the correct 
seouenee Is maintained naturally though the address 
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saved on the stack end no further eheeklng Is ne- 
cessary* Departures from tMs seaueoee ere accom- 
plished, In General, by adjustment of the saved ad- 
dress 

The mainstream eroeaea is Illustrated in figure 3-16, It 
basically follows the outline given belowt 

1, Save the user Line and Link-bloek addresses In the 
DDB and remove from the stack 

2, Perform the followjne cheeks on the reouest validi- 
ty. For failure In either Case call a fatal error 
(F010) - see ehaoter 7 

a. Function and mode acceptable forth* device as- 

sociated, with the dataset, usino data In the 
driver interface table (see section 3.3,1) 
(e.g. A ouneh. eannot read, nor ean a line 

orinter handle binary data) 

b. * valid .OPEM call ereviouslv mode for all 
f llo-struetured devices, 

3, Prepare the DDB for the transfer! 

a. Clear Byte Count & Checksum, 

b. Verify that an Internal buffer Is attached to 
the DOB, Jf none, because of no,, OPEN on a 
non-file devlee, claim one now and link It to 
the DDB (start address ft sice),, (If none Is 
available, recall the Program via. the user 
Llnk-blpek error address or call a fatal error 
(F007) If this Is 0). 

e. Collect the variable pointer to the buffer 
saved In the DDB Driver Word Count end replace 
it bv the, buffer end-address computed from 
start ft size. 

4, Set Banisters (based on data passed by the orogram 
where neeessarv) to show! 

R0 ■ Address of the Bvte Count in the DDB 
Ri ■ Address ?f the. nest Monitor buffer. 

byte (8 if buffer emotv) 

R2 ■ Address of the Byte Count in the user 
line 

R3 ■ Mode ft current status (may be 

accumulative durino the transfer) 

R4 * Address of the nest byte In the user 
Line 
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R5 ■ (Temporary work-space) 

5. £al) the unique .READ/. WRITE routine* at indicated 
in the previous oereoraoh in order to eo-plete Ini- 
tial iiation and collect the first data bvte. 

6. For all data modes* count the byte and accumulate a 
checksum, in the DOB (the latter for simplicity# 
whan It la only real 1 v necessary for formatted bi- 
nary), For ASCII modes in particular# atrip or 
generate bit 7 (the parity bit) within the bvte as 
raauiredf for fgrmatted versions# sat an 
End-of-uine (EpL) awiteh (by clearing the user Line 
Byte Count) if the bvte is a 1 1 ne-del 1 ml ter , 
Recall the unique routine to complete the process- 
ino & storage of the bvte, 

7. If now at the end of the Monitor buffer# cheek If 
fn End-of-Data (EOD) occurred at the previous dev- 
ice transfer. In this ease* set appropriate status 
flags in the user Line-bloek and reeall the eregram 
as in step 11, Also clear the. variable pointer to 
fores aubaeouent attempts to fill or emetv the 
buffer to make this cheek again, 

§, Otherwise save tha current pointer values In the 
009 or user Ljne-bloek and, prepare to call tha 
driver. In particular# for a f 1 1 e-at ruetured dev- 
ice as defined in chapter 4# determine the nest 
device block (the routine to do this is embaddedt 
it# description however has been Included In eon- 
test in section 4,5,2). Call the driver vie S.CDB 
and return to the program until done, 

9, On reeall# dequeue the driver via S.CDO, Check for 
device Parity failure or FOD (as ahipwm by an unes- 
oired word eount returned by the driver) and set 
DDB flags accordingly, (Again If a f 1 1 e-st ruetured 
device is being used# some dean-uo and checking la 
neeessarvi this. Is also covered In section 4, 5,2), 
Restore saved pointers, by returning to steo 4. 
Poree return after initialisation to the nest steo 
to omit further byte transfer at this stage 

I®. If device action Is not vet required, or has been 
completed# cheek for the end of the user line based 
uppn either the EOL awiteh mentioned In step 5 or 
upon the Byte Count In the DOB belno equal to that 
supplied bv the program (unformatted -odes only). 
If not seen# recall the unique routines for further 
Checking and collection of the nest byte as neces- 
sary# with a return at steo 6, 
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11, When the previous step shows the transfer Is eon* 
olete* set status Information and. byte counts Into 
the user Line-block, Save the buffer pointer in 
the DOB and dear its Busy Flea*. Restore the saved 
program Registers from an otherwise cleared stack 
and reeall the program. 

From the above sedufnee^lt ear be seen that the.unlgue rou- 
tines are called for four purposes and by definition these 
differ for .READ end .WRITE « 

a. Initialisation on first entry and collection of 
the first byte 

b. Completion of individual bvte oroeeaaing 

e. Reinitialisation after device aetlon 

d. Further EOL eheeking end collection of aubse- 
ouent bytes 

For .READ* these .oofratlona ere outlined below end ere 
further detailed in figure 3-17i 

1. For first Initialisation* the followino tasks are 
carried out! 

a. Set the user linf Byte Count to the maximum 
site! if none Is given* return to the program 
with an invalid line error, 

b. If the Internal buffer Is empty (as fhown by R1 
■ 0), return to step 8 In the mainstream to 
eause a fill bv the driver (or to see an EOD 
set in a previous .READ) 

c. For formatted binary modes* look for the first 
non-0 word (with intermediate buffer refill If 
neeessarv). If this is net 1 as reaulred bv 
the format* reeall the Program with fomet er- 
ror indication* Otherwise store the Bvte Count 
from the data in the user Line-bloek, 

d. Collect the first data bvte for orocessinq. 

2. ^o further bvte-oroeess 1 ng Is reouired for binary 
data* so store the bvte and reeall the mainstream. 
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For ASCII data# however the followino additional 
steps must be taken before this eceuns(l)i 

a. In all modes# Ignore nulla, 

b. Ignore RU0OUTS In formatted mode* and eheek 
parity# If naeeaaarv returning the aoorooMata 
error indication to the Program, 

3. On return from driver action# the mainstream ean be 
recalled immediately .for EOL cheeking unless the 
line has already been filled, in normal formatted 
mode* and exeess data Is beino discarded. In this 
ease# a line pointer reset on the beeis of "line 
start ♦ number of bytes read" would eorruot the er- 
as outside the line proper# h*nce reset the oointer 
to the last aetual bvte of the line before recall 

A, If the Svte Count in the DOB and In the user Line 
ere eguel on return for additional POL eheeka# the 
EOL swlteh Is set for formatted binary operations. 
In. this ease# verify the Checksum and transmit an 
appropriate error to the program as neeessaryi re- 
turn to the meinatream to recheck for buffer end. 
In all other. cases of reeall from the mainstream# 
it. is oosafble In formatted modes that no further 
room exists In the user Line as shown by the mexl- 
mum Bvte Count. (because of no ASCIT line delim- 
iter or too long a binary line). Hence check for 
this and If there ia no problem# return to steo 1 
to collect the next byte. Otherwise return an In- 
valid line error to the user endi 

a. In Normal formatted modes# set yp to overley 
the last line byte and continue from ateo 1, 

b. In Soeclal modes# reeall the proarem (For for- 
matted binary# th* Byt* Count Is set to show 
the full line size to indleete how many more 
bytes must still be read) 

Fpr .write# the gnloue operations are as follows (see also 
figure 3—183 s 


1, If an EOL Is seen In formatted. ASCII .modes# .the mein- 
stream eheek on the end of the Monitor buffer Is In faet om- 
itted. If the device Is a terminal the operator may not be 
ready to inout more data as needed to refill the Monitor 
buffer. Hence In order to oass the already eomolete data to 
the orognam as oulcklv as. possible# the normal eraetlee of 
maintaining data in the buffer at all times may be over- 
looked In this ease. 
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1, Initialization on first entry reouires the follow 
i na actions* 

a, If no By$e Count is provided by. the program# 
return with an invelid line error indicated, 

b. If the buffer* bee Juet been claimed# zero It 
eompl etel y 

e. If an E00 was seen on a ©revieus .WRITE# recall 
tbe ©pogrom to show tbie, 

d. If a formatted binary transfer ft reauested# 
store an intepline < 5*0 (8 nulls! followed by 1 
(for bfnapv node) and tbe user Byte. Count In 
the internal buffer# provided sufficient noon 
still renains. If note Peeal 1 tbe meinstream 
at step 7 to.emptv It first, Also Initialise a 
checksum to include tbe data Just stoned, 

e. Collect the byte and for formatted ASCII modes# 
remove any parity bit. Save tbe user Line Byte 
Count (see 2 below), 

2, For all modes but formatted ASCIT# no further 
byte-DPoeessino Is neededf merely store the bvte 
and return to mainstream, Otherwi so, the following 
eheeks must be carried out before this* 

a. If an EOL terminator was seen# eheek if the 
user line is empty. If not and the mode Is 
Normal# restore the saved user Line Byte Count 
end continue. 

b. Also If at line-end# force outdut to a terminal 
device, 

e. Provided there Is room in the internal buffer# 
follow horizontal TAB with PU90UT and vertical 
TAB or form»feed with nulls. Otherwise force 
outout first. 

3, To reinitialize after a device transfer# clear the 

buffer unless an. E00 was seen, in which case recall 
the ©regra* as in 1, For the formatted ASCII 

modes# perform the actions noted in 2(e). 
Otherwise return to the mainstream. 

4, If a formatted binary line has been eomoleted# 
store the Checksum in the buffer and return to 
check if the buffer is now full for output. 
Otherwise eelleet the next bvte and repeat from 
step 1(e). 


PAG* *-33 


Comment • I 

The_ • BEAD/, WRITE Processor returns to the program when Held 
up for a device transfer as shown at step 8 of the melnstre- 
am seouanee. The normal requirement that the program per* 
form .a .WAIT before aeeassing the line t heref ore, aool 1 es. 
In this case it also is imperative that tha user Line-block 
Is not fhanoed before the transfer la known to be complete 
beceuae.cf the intermediate data atored In it. On comple- 
tion*., it ia the program' s resoonsibi 1 1 tv to verify the accu- 
raev of the transfer by examination of the status returned 
bv the Monitor, 


Because of its size* RWN eannot be brought into the Swap 
Buffer, Although this eould be effected as for other rou- 
tines by an overlay or ogees, this would mean that 
re-entreney would be sacrificed making it Impossible to pro- 
cess more than one request at a time, In the ease of 
,RtAD/,WRITC this is somewhat unrealistic. The nature of 
the progassing Involved too does not lend Itself to simple 
oyerlaying as It is not sequential, An alternative method 
might be to use the Swap Buffer fori sav, the mainetreem and 
claim a separate puffer for use by the unique routines - a 
feasible, solution ajnee. the co-routine technique een be sim- 
ply adapted to provide it. However again size, particularly 
with the addition needed to control the extra operation, 
pravents tha adoption of this method,. Therefore for the 
present* the .READ/, WRITE processor must form oert of the 
permanently reeident Monitor - a net entirely uneat i sf aetory 
constraint when moat orograma will probably require Its ser- 
vices. too frequently for swapping, With regard to RWN 
re-entreney* it muet be noted that it may also eall the un- 
protected. S.GTB routine as diseussed under . TNJT (section 
3,2.1.11 if, the program does not call .OPEN first. Again 
thla l.a no problem In a single-user systemj for real-time 
operations, the standard use of , OPEN can obviate It, 


3. 2. 2. 3 Dataset Close CCLS) 


The .CLOSE eall enables the user to Inform the Monitor that 
eyrrent. transfer operations within a data-set are to be ter- 
minated. Its. proeessino includes the output of anv data 
still In the internal buffer, any necessary shut-down action 
on a non-fi 1 a .device (e.g. Puneh trailer) or directory cle- 
an-up on a f 1 1 e-or 1 ent ed device and finally the release of 
the Internal buffer, .The device driver and the DOB however 
remain In memorv, linked to the user orogrem. Thus opera- 
tions c§n bs resumed by a new eall to ,OPFN. Again, for the 
aake of deylee-lndependenee, use of thie call is recommend- 
ed, even though It is only essential for file operations 
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(tinea t . RLSE eall performs .CLOSE operations In other 
eattt • sat taction 3.2.1.35(1). 

Cal 1 1 ng Seauencet 

The calling taquanee for .CLOSE Is simolyt 

MOV *LNKBLK,-(3P) iPASS LINK-BLOCK ADDRESS 
ENT 17 ICALL .CLOSE 


Proeessinot 

The .CLOSE erocesgor is outlined at figura 3-19, At with 
•OPEN (tat taction 3.2.2.1), .CLOSE cells ana handled Ini- 
tially by a general routing for. all davlcet. This may than 
ba followed by a call to the file-management nodule FCL If 
the device. Is f i 1 a-ori anted. The general routine uses the 
seauenea given belowi 

t, Cigar the eall parameter from stack sod gat the 
driver address from the DDR. 

2 , Verify the e*1st§nee.of any valid data. remaining In 
the internal buffer if th« last operation performed 
was output (uslno the last value of. the variable 
buffer Pointer stored in the DDB Driver Word Count 
by the .READ/, WRITE processor (sea last section)), 

3, If such is the ease and the device is 

f i 1 e*or1ented» cheek that no EOD has been seen - 
the lest block. has already been eytdut In this 
ease. For .linked files (See section 4,1,1), sat 
the lest 0 link ft the DECtaoe transfer direction. 

4, Cell the driver, via S.CDB to aetlgn this last out* 
out (1) and return to the celling program until 
done. Dequeue the driver by S.CDQ on reeall. 

5, Clear the Open Indicator in the DDB Status and 
eheek for a f i 1 e-struetured device (see next ears* 


1. The last output In faet Is a full buffen - the last val- 
id data .followed by nulls. On f 1 le-oHented deviees, this 
may mean in the worst ease that. the lest bloek of a linked 
file is all null. Although this Is wasteful, it avoids the 
necessity of re-aeeesslng the previous block to ehanoe Its 
1 est link to 0, 
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graph If to) 

B. For non-file devfc««» e a 1 1 the driver* via S,CDB If 
It, contains a CLOSE routine as Indicated by a 
awiteh in Ita standard Interface table (see taction 
3,3,1), Again return to the eallino erogram until 
eo"p1 ate, 

7. Uajna the. standard buffer else stored In the 
driver's interface table* release the internal 
buffer to free eore, via 3.RLB. 

B, Clear the DDB Busy Flao and take the usual system 
Exit. 


As noted in the last paragraph, a .CLOSE eall on a dataset 
uplng a file-oriented deviee requires a subsidiary eall to a 
f i 1 a-m»nademant module. By a similar method to that des- 
cribed .for .OPEN In aeetlgn 3, 2.2.1* this Is effected with 
appropriate data Passed as follows* 

RB s Address of the DDb 
R 2 ■ Address of the FIB 
R3 « Address of the driver 
R4 ■ Original Open type eode -2 

In addition* bit 15 of the User Line Address in the DOB la 
set as a DECtape marker. 


Comments* 

Because 8wao Buffer everlayi.no is aoa.ln a possibility* the 
remarks, In the lest paragraph of section 3,2, 2,1* also apply 
to the .CLOSE routine. 


3,2.3 Random Aeeess I/O (BLO) 


It will be shown In chapter 4* that a user can reserve an 
area of physically adJaeent blocks upon a. bul k-storage medi- 
um by requesting the allocation of a Contiguous file. The 
.BLOCK call Is provided as a means whereby he can then ac- 
cess the area randomly. The user identifies s physical 
bloek. by its relative position within the area. The .BLOCK 
processor transfers the required block in. a specified direc- 
tion to or from the normal Monitor buffer and then allows 
the user to oroeess his data dlreetly In the buffer, rather 
than .cause a^further unnecessary move to or from tha user's 
own area. Before, .BLOCK is used, the user -ust correctly 
OPEN the file in order that the Monitor can establish its 
buffer* .OPENU allows both reed and write* .OPEnI allows In- 
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put onlv. On completion .CLOSE must also ba eelled. 

Although it was saen In section 3,2.2, that the normal 
PEAD/yRlTE level can ba used for sequential processing of 
any tvpe of file# tha aama does not apply to the use of 
•BLOCK for random aeeass. The nature of sequential files on 
bulk storage devices. described In seetion 4,t,1. would make 
the use of *BL0CK too lengthy a oroeass that for the oresent 
It has not bean Implemented. Random aeeass. of eourse. on 
other, devices la meaningless* while tha ability to use 
.BLOCK perhaps as a means of sequentially proeesainq data 
within , tha. Monitor buffer might be useful, the same affect 
can ba obtained bv .TRAN with very little extra effort by 
the user, Henqf the .BLOCK processor only aeeepts ealls 
upon contiguous files and rajeets all others as Invalid. 


Calling Sequence* 

.BLQCIJ, actual 1 y provides three functions. For inout, It Is 
sufficient that the user requests the block amd the Informa- 
tion on. the, bloek Is returned so that he can process Its 
content, For eutout, however, the user must supply the data 
before It can, be transferead and to do this he must know the 
buffer location and ei*e In advance. Hence In addition to 
READ and HRITE a block, a GET operation Is provided for the 
purooM, „ To Indicate the function and allow the Monitor to 
return Infgrmftion, the user supplies a. 81 OCK-bl oek, as Il- 
lustrated In figure 3-2P and described in more detail In the 
proorammeris Handbook. 

This then means a calling sequence as fellows* 

MOV *BLK8LK,-(3P) fPASS BLOCK-BLOCK 

MOV *LWKBLK,-CSPJ *... LINK-BLOCK ADDRESSES 

EMT 11 »CALL .BLOCK 


Proeesainq* 

Tha sequence of operations in the .BLOCK processor Is quite 
straightforward* thua no illustration Is neeessery. 
Basically the following stees are taken* 

1, Collect the address of the user BLOCK-bloek and 
dear both arguments from the stack by movlno the 
saved program Pealsters down. 

2, Move the eddreee_of the Monitor buffer into tha 
BLOCK-block, If no buffer is set up. no .OPE 1 ^ has 
been done. Return the appropriate error flao In 
tha BLOCK-block status and exit as 1m step 7, 
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3, Extract the buffer size from the standard driver 
interface table (see section 3*3.1) end gtere I t in 
the BLOCK-bl oek, If the requested function I a GET* 
oroeeealng 4a now complete* so exit as In step 7. 

4, pejeet tha .BI.0CK reaueat by returning the appro- 
priate error flag in the Bl.OCx-bloek status for any 
of the following reasons* again taking an exit as 
In step 7* 

a. The device Is not f 1 1 e-st ruetured, as shown by 
an Indicator In the driver Interface table. 

b. The function Is not BEAD on WRITE# 

e. The file has, bsen Incorrectly opened* based 
upon, the Oeen type eode saved in the FIB (see 
section 4.3.2)* i.e, .OPgNU has not proceeded 
READ or WRITE, or .OPENI for READ only. 

d. The block requested is outside the range of tha 
file af stored in the FIB, (where block 0 of the 
file is the first and the last is thus 
Length-1) 

5, Compute the absolute block from the start stored in 
the FIB and set go the DDB for the transfer speci- 
fied. 

B. Call the driver to effect the transfer via S.CDB 
and return jo the.uaer until done. On return* de- 
queue the driver via S.COQ end return any parity 
error In the BlOCK-bloek status. 

7, Cigar the DDB Busy Flag and take the normal System 
Exit. 


Comments I 

Because of the Intermediate return* the user again must call 
•PAIT before attempting to oreeeas the buffer and It is also 
his reaoona I bi 1 1 1 v to cheek the returned error status to en- 
sure the transfer required has been sat i sf eetnr i I v executed. 
The .BLOCK processor is always reentrant* whatever its loca- 
tion. 


3.2,4 Special Operations 

Two further I/O functions are provided bv the Monitor to 
eater for the fact that while device-independence is gener- 
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•11 v feasible fop normal data-t ransf ere# certain devices re* 
quire ppeeial controls whleh.the program Itself must be el* 
lowed to manage If the user wishes. Thus the .SPEC cell Is 
a general . means bv whieh the user een exereiae sueh controls 
end this Is described In section 3,2,4, l, it een still be 
used In the deviee-indeeendent environment because it Is ef- 
fectively a NOP If the devlee.in use does not recognise the 
control specified* However# in order that the us$r can avo- 
id unnecessary Monitor ealls and for other situations where 
the. program might need further Information on the assigned 
device# the ,STAT eell# outlined in seetfon 3, 2. 4,2# Is ava- 
ilable. 


3,2,4. 1 Special Functions (3PC) 

As noted above# the .SPEC eell is a means whereby the user 
can request e devlee-drl ver to perform e special function 
which does not generally require e data-t rensfer in the nor- 
mal sense covered. bv the processes in the previous sections. 
Magnetic taoe Rewind is e typical example. Potentially, any 
driver may eontaln a Special Function routine# but this is 
only actual lv, Included when meaningful# either because the 
device .Itself ean expect the function or It can be simulat- 
ed# e*g, .although it Is not currently implemented# a Rewind 
on DECtaoe Is not out of the. quest ion. Thus the .SPEC pro- 
cessor only cells the driver if the routlne.ls seen to be 
present* as Indicated In the standard interface table In the 
driver (see section 3. 3,1,1), However the routine's pres- 
ence dees not neeessarilv mean that the driver ean always 
satisfy the function! while the magnetic taoe driver# for 
Instance#, ean accept a Rewind call# It will not understand 
eome so?eia1 operation to control a display. The .SPEC pro- 
cessor In Its general way, cannot discriminate. It is there- 
fore the responsibility of the driver to ignore functions It 
does not reeoonize (see section 3,3), 


Calling Seauenee i 

The soeelel funetjon itself Is defined by a p ode# assigned 
as the need arises from the range 0-255. This eode Is 
passed as. a eall earementar, .In some cases* the function 
Slone defines the user's requi rementsi In others* additional 
Information is needed to support the function. or perhaps the 
Monitor, must have the opportunity to return status data. 
There ere therefore two possible calling sequences# the re- 
levant one In eaeh ease being defined by the specific func- 
tion* 

1, If only the function needs to be passed# this forms 
the argument* 
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MOV *CODE.-(SP) t STATE THE function 

MOV PLNK0LK* • ( SP) tPASS LINK-BLOCK ADDRESS 
EMT 12 tCALL .SPEC 

2. If suooort 1 nf ormet 'I on mutt tlao b« supplied# the 
program sets uo a Special Funetlgna nloek# Illus- 
trated at flours. 3-21, This contains tht eode for 
tht function basically and allows a variable length 
work-aoaee as neeassary. In this ease* the address 
of this bloek la the argument* 

MOV aSPFBLK.-CSP) tPASS SPF-BLOCK 

MOV PLNKBLK.-(SP) I .. .LINK-BLOCK ADDRESSES 

EMT 12 ICALL .SPEC 

Before the eel 1 Is made* the dataset must of course be Ini* 
tiellsed by ,INIT to load the driver into memory. In gener- 
al# however* it should net follow a .OPEN unless this has 
been negated by .CL08E. 


Processing! 

The .SpBJC oroeess needs no illustration! it merely follows 
the slmole steps listed below! 

1. Save the function argument In the _DDB (User Line 
Address) and clear both arguments from the staek. 

2. If the high-order byte of the function argument is 
0#. the user has passed only the eodel this follows 
from the allotted code ranoe end the feet thet an 
address must be greater than 400. Henee eheek this 
byte. Move a coda-only argument to Fyte Count In 
DDB and reolaee it In the User Line Address word bv 
the address of Its new location. 

3. Extract the driver address from the DDB end verify 
the presence of^a Special Functions routine In the 
driver from the flag in its interface table. If 
none* exit as in steo 5. 

4. Otherwise eall the driver vie S.CDB and return to 
thf program, until done. On return, deoueue the 
driver via S.COQ. 

5. Clear the DDB Busy Flag and take the normal Svstem 
Exit. 
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Comments! 

If the driver is ealled# the operation et step 2 ebove means 
that the User Line Address in the DOB always contains an ad- 
dress pointing to a Seeds! Functions Block aa far as the 
driver Is concerned • even if this merely consists of a sin- 
Ola word elsewhere in the DDB. The driver can thus assume a 
standard procedure fpr extract1ng,the code end cheeking both 
that this is eporooriete to itself end that the required 
number of words follow (the high-byte 0 noted In step 2 aga- 
in olves to correct result). 

•SPEC is fully reentrant regardless of its location ft usage. 
However devlee action, may be neededi , hence, for safety the 
prooram should .WAIT before proceeding in many esses. 


3. 2. 4. 2 Device Status (STT) 

As statfd,eer1 ier# the .STAT call allows the user prooram to 
obtain Information on the device a dataset is actually using 
for a particular run# after It has been Initialised in the 
usual way bv •X^IT. 


Cal 1 1 ng Seoueneet 
The call is made byt 

HOV *LNKBLK,.(SP) »PASS LINK-BLOCK AODR 
EMT 13 ICALL .STAT 


Proeeseinat 

The .STAT processor merely extracts the relevant data from 
the, driver associated, wi th the OOP by referpnee to Its In- 
terface table (see Section 3,3.1). The date is returned on 
top of the staek. However# three items ere supoliedi 

1. Driver Facilities Indicator (see Section 3.3,1 for 
detail ) 

2. The name of the devlee In Backed radix-50 format 

3. The size of the buffer deemed the devl ee-standard 

Since onlv one argument Is Passed# the .STAT routine con- 
tains an_ appropriate stack-shuffle operation. The Normal 
System Fxit Is taken to recall the program. 
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Comments I 

The ,STAT routine la also fully re-entrant. Moreover be- 
cause np a$tufl driver action la necessary# tha raoulrad In" 
formation la immediately available to the orooram whan re* 
called.. At In other eaaaa where data Is returned on the 
stack* It is tha Program's responsibility to clean-up after 
tha data has served Its puroose. 


3.3 Oevlee Drivers 


Much has bean said In the previous sections eoneeming the 
fact that in order to provide a device-independent environ- 
ment* the drivers for al 1 devices present a standard Inter* 
face to .the Monitor routine servicing a program 2/0 request. 
Tha purpose of thjs section is to summaries the features of 
the interface mainly, fpr reference. Appendix G of the Pro* 
grammar's Handbook provides a fuller deserlotion. 

Sections 3.3.1 through 3.3.3 dlseuss the two main parts Into 
which evgrv driver can be divided* a standard interface 
tablf# whieh must. come first# and a package of routines to 
service the different tvpes of Monitor request and the 1n*i 
terruets occasioned by these. Section 3.3.4 than notes a 
problem peculiar to the driver for the svstem-devlee. 
Description* of the currently Implemented drivers are avail- 
able within tha Device Driver Package document, The driver 
for the ASR-33 Teletype Is described In Appendix A. 


3.3.1 Driver Interface Table 

The flrat part of every driver is a standard table whieh ean 
be referenced by every Monitor routine# flratlv in order to 
determine the caopbl 1 ities of that driver, and seeondlv to 
aeeass the appropriate serviee routine via the Driver Queue 
Management subroutines, 8. CDS or S.CDG (see Section 3.1. 2,4) 

The format .of, the table la illustrated at figure 3-22, In 
offset. it is in two parts# the first of which. must appear In 
*11 drivers# the seeond Is neeessarv only In drivers for 
f j 1 p-st fuetured devices as described in ehaoter 4, The sig- 
nificance of the entries Is as follows* 

1. Busy Flao - is a 0 when the driver Is available for 
use and Is reset by S.CDB to the QD* address for 
the dataset being serviced while the. driver is busy 
(see section 3 S 1.2.4), It enables the driver to 
aeeess the transfer control parameters passed bv 
the celling routine. In general# the driver does 
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net elear tMi flea • this is dens hy 3.C0Q 
(however sss section 3*3.4) 

2* General Facilities • U f series of hit-awitehea to 
ensure that ths driver is onlv called uoon to pro* 
vide services of whleh it is eeosble* (bit set to i 
in each ease)! 

bit 0 ■ mul t 1-detaset suooort 

this bit is checked bv the .INIT 
routine to prevent the assignment 
of a single-purpose device like 
e paper-tape reader to more than 
one dataset at a time* 

bit t ■ Outdut 
bit 2 • Input 

These. two bits pre uied widely to verify 
transfer direction validity (1) 

bjt 3 ■ binprv 
bit 4 • aacfl 

These two, bits enable rejection of data 
modes which ere uneeceotebl e, e.g. binary 
on e keyboard* 

bjt 5 • Soeciel Function routine present 
bjt 6 ■ Close routine present 
bit 7 ■ Ooen routine Present 

these bits are used bv the relevant routine 
(.OPEN, , .CLOSE, .SPEC), to ensure that the 
driver is not eelled if It is 
unable to supolv the service 
(see also next section) 

3 . Special Facilities • aoein uses bits to Identify 
eartieular faeets of the driver* 


1. The cor respond! ng bits are used In ell Monitor transfer 
f unet 1 one for ease of eheeki no, e.g. , Mr } te*2, ,PE4D«4 * 
file type codes Inelude them, ete. In many esses they also 
ere similarly used for devlee hardware control. 
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bit 0 ■ terminal device 

THIe bit thews thet the driver controls e 
device like the console typewriter which al- 
lows manual data-entrv and therefore raises 
aoeelel problems noted In Apeendix G .of the 
Programmers Handbook. In oartieular# 
.WRITE forges put out at FOL even though the 
Monitor buffer Is not yet filled. 

bit 2 a multi-unit system-device 

As shown under 10 below, further table en- 
tries contain, bit moo polntary for gaeh unit 
under 1 controller. If the driver Is real- 
dent# as in the esse of a svatem-devlee sueh 
as RK11* all these entries mutt be cleared 
for a fresh start after a program failure, 
this bit shows that there Is mere than one 
entry requiring such treatment. 

bit 5 ■ sequential magnetic tape 

This bit shows that the device# though not 
fully f 1 1 e-struetursd as defjned In Chapter 
4# has nevertheless a basic file format as 
described In section 4.7. 

bit 6 a reverelble medium 

This bit classifies s deylce, like DECtspe 
which allows transfers In either direction 
of teoe motion and thus needs seeds! treat- 
ment (see section 4.2.3) 

bit 7 ■ f i le-struetured device 

This shows the device hes full file capabil- 
ities as in Chseter 4 

Sttndard buffer Size • shows the number of 16-word 
buffer units to be claimed via S.GTB (see Section 
2.4,2) for the Internal buffer used in .REAP/, WRITE 
end BLOCK level I/O, 
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5. Offset to Interrupt Service Routine • enables the 
initialisation routines to set. the appropriate ad* 
dress intothe device interrupt vector when the 
driver is in eore(l). 

6. Interrupt Prjortv Level * like 5* is used to set 
the status into the interruot vector. Normally it 
is the same ee. the level at which the hardware in* 
terrupt oceurs. 

7. Offsets to Routines • ere referenced bv their rela- 
tive Position in the table whenever ,e. Monitor rou- 
tines wishes to call the relevant service via S,CDR 
(see seel ion. 3. 1.2.4) . These bytes arp set to 0 if 
the routine is not provided - else indicated bv the 
corresponding general Facilities indicator (see 7 
above) , 

8. Device Name • is the peeked radix-50 value for the 
eode allotted to eaeh device. 

9. MFD Start Block M - is the basis for the file 
structure on a bulk-storage device and is discussed 
in section 4,1. 2.1 

10, Bit-mao Pointers • enable the chaining of several 
datasets shsrina the seme unit of e bulk-storage 
device for output and henee the same in-eore block 
allocation bit map as described in Section 4.1.3, 
There mev be either 1 or 8. entries, deeending uoon 
whether the deviee has e single unit or several. 


1. As shown in the Proorammer's Handbook, the offset ean be 
a positive, increment of up to 256 words. In the laroer 
drivers* this may be insufficient* in that ease it mav ooint 
to e JMP or BR to the real start of the routine. 
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3*3.2 Driver Servie* Routine* 

Xn general env driver mey be ealled.te provide one of four 
services end "av therefore contain the neeetaery routines 
for the ouroostft 

e. Trenefer 

b* Open 

o* Close 

d* Speelel function 

The first obviously is * raauirement in ell driversj the 
othpr. three erf oreeent only. if some eetuel ohyaieal device 
action cen be effected* For instance* e console typewriter 
output can be ooened 9 r closed wlth.CR/LF outout* whereas on 
e f i 1 *• jt ruetured device as shown, in Chapter 4# both of 
these functions .ere In feet eerformed.bv normal transfers* 
Hones the, aoproori etc Monitor routines first eheek the Gen* 
oral Facilities awifeh* described In the cirfvieu* section* 
boforp celilno the driver to perform one of these three 
function* (see Sections 3.2*2 and 3*2*4) 

All drivers under. DOS are h§ndled on the . Interrupt system. 
The, servipf routine* therefor* merely initiate the relevant 
device *e$ 1 on» usino the address stored In their first word 
(ee* orevlous section) 

The routine* extract control data supplied bv the Monitor 
routine in the DOB for the dataset reaulring the service and 
transmit it as neeessarv to the device control hardware. A* 
noted. In Section 3*i*2.4* they may use. Registers freelv for 
this orocess* They then enable the device interrupt faclli- 
tv and retyrn to the Monitor routine* to await the f<r*t in* 
terruot using th* eddness saved on the stack by the JSR call 
to 8 . CD*. 

The individual nature of each of the four routines is dis- 
cussed In th* programmer's Handbook* Appendix G* 


3*3*3 Interrupt Servicing 


It follows from the previous . seet ion, that every driver must 
contain a routine to service the enabled interrupts. The 
primary ouroos* of this routine Is to ensure that the data 
is transferred to or from th* deviet in the. form expected bv 
th* csl 1 1 no. Moni tor routine. as satisfactorily as possible 
end to allow for th* handling of any error conditions which 
mey prevent this. The provisions of the devlee hardware of 
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court* the amount of aupo;l ementarv work each 

driver has to do In order to meet this purpose. Aoaln Ap- 
pendix . G of the Programmer** Handbook dlseusses the possi- 
bilities In more detail* 

Generally* thouoh* at eaeh Interrupt the drjver transfers 
data .between memory and the device allowing for th* fact 
that the Monitor ean only recognise ASCII or binary. If the 
driver needs Registers# It is responsible for safeguarding 
their content on the Interrupt entry. If fyrther Interruota 
are needed to eomolete the transfer# the driver take* normal 
RTI exit* to await them. When the whole transfer is done# 
the driver recalls the Monitor routine through the Conple- ? 
tion Return set Into the (508# with any neeess§rv status in- C 
formation Disced In the DDB (parity failure flag In Statust ) 
incomolpte transfer In Driver Word Count). As shown In Sec- 
tion 3. 1.2.4# the Monitor routine exoeets R0 to contain the 
address of the DDB Just serviced and the contents of all Re- 
gisters at the final Interrupt to be saved on the staek • 
the driver ean use the M on1tor*p S.RSAv sub-routine to ef- 
fect .this (see Section 2*4.1). The driver may disable Its 
interrupt facility before, the reeal 1 j it does not however 
adjust .the. Processor priority level or clear the Busy Flag 
In its interface table. The Monitor routine calls S.CDD to 
perform th*s* operations. 


3.3. 4 S y at em-de v i e a Dri v ers 

As noted in t he. i nt roduct Ion to Chapter 2# the driver for 
the svstfm-devie* is part of th* permanently resident Moni- 
tor. Basically this driver.!* no different In function from 
that servjelno the same devie* when this is used as a subsi- 
diary peripheral in a system based en another, similar dev- 
ice. It la called In the same way with its information set 
Into a DDB addressed by the content of its own Busy Flag# 
even though that DDB belongs to the System as noted In Sec- 
tion 2, Moreover system requests take their place In any 
driver oueu* like all the rest. 

Nevertheless in its privileged usage it does have an extra 
responsibility. If a_ transfer cannot be accomplished be- 
cause of soma hardware failure* th* ordinerv driver In moat 
eases eells for some diagnostic message. As Chapter 7 will 
ahow# this requires the loading of a Monitor routine to con- 
trol th* Printing. In the Interim the driver’s Busy Flag 
remains set# as It la still effectively servicing the 
transfer reguest. For the driver of the system-device# this 
eannot bet if this is still seen to be busy# the reouest to 
load the Diagnostic Print routine will ba oueued to welt Its 
turn. To eireumvent this# the driver must itself clear Its 
Busv Flag before reguesting the error message. If neeessa- 
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pv » where the. error can alto bo p«et(fjfd bv operator aetlon 
•nd resumption may than ba requested# it must alao.aava and 
restore the flao eontenf a* appropriate* (In practice# this 
SPeejsl, addition ie Included in the atandard driver aa a 
conditional assembly option • tea aeetion 6.1) 
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CHAPTER 4 

PILE STRUCTURES 




Bulk media such as disks or maqnetie t«oes »r* by their na- 
ture capable of holding many different sets of data, Tha 
sets nav be wholly unrelated to one another and m ay# In 
feet# belong to different uaera sharing the sane medium. In 
the norma] way# none of these users is particularly con* 
earned with how and where his data i* held on the medium as 
long as its initial storage and later its retrieval and ear* 
haps its modification or extension can be accomplished as 
simolv as possible, Moreover each user exoeets some measure 
of protection adainst the corruption of hia^data either by 
himself or other users,, On such media, therefore# the 005 
Monitor, supports a file structure which gives users these 
facilities and this is described in detail in this ehaoter. 

In this context# a "File" is defined as any logically com- 
plete set of data stored on a bulk medium which ean be ac- 
cessed through this, f i 1 e-at rue t u r e • In addition, to the 
files# the medium is also used to store control information 
by which the Monitor ean aeeess the files on the user's be- 
half ( " Di rec t or i as " ) and can provide their storage-soaee 
("Bit maps"). These General concepts are discussed in sec- 
tion 4,1, 

As far as possible# the f i 1 e»st rueture has been designed to 
be dev i ce- i ndeoendent # in accordance with overall Monitor 
ph 1 1 osoohv# , at least in its usage on Disks and DECtaoe, 
However obvious differences in those devices# especially the 
faster disk aeeess mate# have necessitated variations in de- 
tailed application, Section 4,2 ia concenned with these 
var i at i ons , 

Section 4,3. then describes the general manner in which the 
Monitor processes files and section 4,4 deals with some su- 
broutines which are called by the f i 1 e-management processes 
to perform special functions such as directory searching. 
Section 4,5 covers those processes which extend the standard 
procedures described in section 3,2.2 for opening# transfer- 
ring and closing data-sets where these ar$ specifically 
files. Finally section 4,6 examines rout i nes espec i a 1 1 v 
provided to service user reguests for housekeeping opera- 
tions uoon directories or the files in them. 

It will be seen that the tyoe of f i 1 e-st rueture adopted is 
basically dependent upon the fact that the given medium re- 
adily allows uodating in place# particularlv of control in- 
formation. There are inherently major difficulties in doing 
Just this. on industry-comoatible magnetic tapes# e medium 
not Previously mentioned. Because of these difficulties# a 
simpler structure has_been implemented for such tapes and 
this is the subject of section 4,7 
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4.1 General Concocts 


4.1.1 Files 

Ai stated earlier* a file Is any logically complete sat of 
data stored on a hulk-medium within the framework of the 
soeelfl f 1 1 e-st rueture. It Is Identified both by the user 
end 1n|1de the svste* by a name which must start with a 
letter followed bv anv combination of letters and digits uo 
to an overall maximum of 6 characters. The name mav be 
further extended by uo to 3 letters or digits to distinguish 
between Individual members of t*e same file family, For ex- 
ample* extensions PAL# OBJ* and LOA to the namePROGRM might 
signify the assembler source* obJeet and load files for the 
same program. 

The way In which the file Is stored uDon the medium deoends 
upon the wav In which the user normally exoeets to create 
end, later process It, Two methods are defined for the DOS 
Monitor ana henee two different tvpes of file are ellowedi 

1, Linked files for seguentlal access 

2, Contiguous files for random aeeess 

4. 1 . 1 . 1 Linked Files 

When a user wishes to create a new file for data which he 
will build up and usually access seguent 1 ai 1 y by means of 
the .write and .READ reouesta described In section 3,2,2# he 
Is probably unable to predict with any accuracy how much 
storeoe soaee the file will use uoon the medium, Moreover# 
because of the time taken to process each Individual bloek# 
It is almost certain that the medium will have oassed beyond 
the next adjacent block before another transfer Is reoulred. 
Repositioning the medium to use this block is obviously 
t 1 me-wast i no , 

Linked files are therefore sel f-exoandi ng aer 1 es of bloeks 
whleh are not Physically contiguous upon the medium. The 
first bloek for the file is allocated from free space on the 
medium in response to a user reauest for Its creation bv .0- 
PENO, Further blocks are added one at a time automatically 
by the Monitor as the storage of the data reoulres this. At 
the. same time* to. provide for future access* the blocks are 
chained by a link-word embedded within esc* block. The 
first-word of the block Is reserved for this purpose and 
within the file Is set to the devlee address for the next 
bloek in the ehaln, when the file Is finally closed the 
link-word of the last block used Is set to 3 as a terminator 
and any unused oortion of that bloek Is cleared, (An all 
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devices# block P is reserved for system use? there ean never 
therefore be any confusion concerning the terminal P link). 
The format described above Is further illustrated in figure 

4«1 « 

As previously noted# the blocks of a linked file are not# In 
general, adjacent to each other. Optimally they are separ- 
ated by a g$p which Is deemed sufficient to allow the M on1- 
tor ample time to oroeess onebloek before the next regulred 
reaches the read-write head of the device. The number of 
blocks forming this aao is dependent on device characteris- 
tics and is pre-deteml ned for eaeh device. This number Is 
known as the "Interleave Factor" (IF). The gap may of 
course increase between individual blocks deoendina uoon 
current availability. 

The linked file format readily allows later extension of a 
file since more blocks ean he added and linked in^the same 
fashion as durlnq Its creation, Joinlnq linked files to- 
gether Is also a relatively simple process when this con- 
sists merely of the replacement of the terminal & link In 
the )aat block of the first file by the device address for 
the, first block of the seeond file, (1) The appropriate 
Monitor reauests are therefore available to the user and are 
discussed under sections 4,5,1 and 4,6.3, 

On the other hand# linked files are not designed for random 
access since the only means bv which this canbe effected Is 
bv perhaps a lengthy search along the links of the file for 
the required block. Currently the random-access reguest 
.BLOCK Is Illegal for linked files as noted in section 
3.2.3. 


4, 1,1, 2 Contiguous Files 

Continuous files are specifically Intended foe eandom aecess 
through .BLOCK. For this type of usage# the user is llkelv 
to know the sizes of his files, Bv definition# too# the 
current ohvsical position of a medium Is far less relevant 
to the order in which Its data is processed. It is more Im- 
portant that the aetual device block can be readily deter- 
mined from a relative value supplied by the user and can be 
reached In minimal time. Both of these criteria a^e most 
slmolv satisfied by the use of an area of numerically con- 
tiguous blocks on the medium. The resolution of actual 


1. No attempt Is made to fill unused bytes in the last 
bloek of a file extended or the first file appended, while 
these bvtes (all null) ere no problem In ASCII files or For- 
metted Binary# they can be read as data In Unformatted Bina- 
ry, Thus# extension or eopendaoe of files In this mode is 
currently not recommended. 
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block Is obvlouslv a simple calculation provided that the 
start block of the area Is known, It also follows that res* 
t r 1 pt 1 no ope rat loos or the file to a comoaet area on the 
medium affords optimal access? Particularly on movlnq-head 
disks because of the matter of head"POs 1 t 1 onl n9 and on DEC* 
tape because of Its single linear track nature, A eontlqu* 
ous file format Is shown at figure 4-2, It should be noted 
that no link-words are provided sinee they serve no useful 
puroosei all words including the first one are thus used for 
date storage. 

Before a contiguous file ean be used? Its storaoe space must 
be ereal located thnouah the , ALLOC request described in sec- 
tion 4,6,3, Because the same medium may be shared bv both 
linked and contiguous files? some conflict In block availa- 
bility must eventually occur? even though the madium mav not 
actually be filled. To delay this as long as possible? 
linked files are set up on all media at the front? or 
low-address? end? and contiguous files are given space 
starting from the high-address end, _ If the conflict does 
occur? as evidenced by a failure of the , ALLnC processor to 
find sufficient soaee for a new contiguous file? the user 
must .either delete some of his other files or , t ranaer 1 be 
them in orger to utilize more fully smaller disconnected 
gaps between used blocks? possibly created by earlier dele- 
t i eng. 

This sl-ole approach to random access has Its disadvantages 
In that? once the contiguous file area has been established? 
It eannot.bp extended sinee there ean be no guarantee that 
the requisite adjacent bloeks are available! nor ean aueh 
files be Joined together unless thev are Juxtaposed? an un- 
likely situation In most Instances, A user reouest for ei- 
ther of these operations will therefore be releeted. by the 
Monitor. Against this? however? the user Is not limited to 
random access on contiguous files. Provided that he ooen 
the file by the appropriate .OPENI or .OPFNC command? he ean 
process his data sequentially bv .READ or .WRITE?. The Moni- 
tor also ensures that such operations are effected only 
within the preset file-bounds. 


4. 1 . 2_ _DJ>ee t or 1_es 

The Monitor employs a two-tier Index structure which is 
stored on the medium with the files In order to maintain 
control Information uoon those files and on the users to 
whom thev belong. At the first level? a Master File Dlrec* 
torv fMFD) primarily Identifies the authorized users of a 
medium and. indicates the start point for the second- level 
User Fjie Directory (UFD) associated with each of these 
users. The UFD catalogues that user's files. 
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Before • nedl um can be uaedfor file-storage* a basic direc- 
tory atruetura consist ing_ of the first two blocks of the MFD 
must be established uoon it. This mav be effected in one of 
the fol lowing ways! 

1, On the evatem device* or on unit f> of the system 
devlee* If thla has several units* the basic direc- 
tory Is auto-at 1 eel 1 v set uo as oapt of the loading 
of the system bv the SYSLOO proqram (see section 
*. 2 . 2 ). 

2, Other deyleea or other units of the system device 
must be initialised by means of the /ZF awiteh pro- 
vided by PIP-11 as described In the relevant manual 
(DEC-ll-PIOA-O) 

In essence, the dlpeetoples at both levels «p« themselves 
linked files In that the Individual devlee blocks allocated 
to them ane chained thpouoh the fipst wopd of each block and 
fyrther blocka may be added aa and when th?1p data-soaee Is 
filled (except on OECtape fop reasons given In section 
4.2.21. 


4. 1.2.1 MFP 

The MFD always stepts at a block (MFDl ) whieh Is preset for 
each device. The devlee address fop this block is stored 
within the relevant devlee driver Interface table discussed 
In section 3.3,1, It Is the only data not stored uoon the 
medium Itself and is the stert-ooint from which all file op- 
erations are begun. However by design MFDl falls within the 
ares reserved for Monitor uaaoe on a medium used aa system 
device! It eould therefore be wr 1 1 e-p<*oteeted in future Mon- 
itor revisions, is a result* the data it contains is set up 
dyrina medium-i nl 1 1 al 1 1 at 1 on and thereafter Is only read. 
Figure 4-3 shows that this currently Includes general eon- 
t rol dat a such as the fixed Interleave Factor for the device 
and pointers to blocks reserved for bit maps (described In 
the next section). It also of course gives the link to the 
second mpo block (MFD2) whieh starts the directory nrooer. 


MFD2* 1 n general* Is allocated space at the h i gfc-address end 
of .the medium (DECtaoe excluded)* also during the initiali- 
sation mentioned previously. Its formet end that of subse- 
quent bloeka whieh mav be added later (a feature however not 
currently implemented) Provides for e series of four-word 
entries, as shown in figure 4 - 4 , The significance of each of 
these words Is as follows! 

1. User Ident 1 f i cat 1 on Code (UIC) - Is a two-byte va- 
lue Identifying the individual user and the orouo 
with whom he may be working* as described In the 
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Programmers Handbook 

2, UFO start block • points to the start of the par- 
ticular user'e UFO chain (Initially sot to 0) 

1. Hu*bar of words oar UFD entry • is provided against 
possible future ehanoea in the f 11 e-st fucture which 
* 1 oh t load to exoanalon of each antrv (currently 
sot at 9) 

4. (Reaervad for future exoanaiop,) 

After Ini 1 1 al i zat 1 on, the only entriea In th# MFD on the 
evstem-devl ce are the System itself (User 1,1) and a "goner* 
al user" (200#203)| on a non-svatem-deyiee or unit there is 
Just one - that for the user who redueated tha Initialize* 
tlon, aji other entries are zeroed* Before any other user 
can store files on the same medium, he must reouest th® set* 
tino-up of his entry by means of the /EM switch in PIF-11, 
Until the us?r actually eraatas his first file, however, no 
UFO Is established and his MFD link word remains at 0* 

4*1*2. 2 UFD 

The format of each UFD bloek is deoleted at figure 4.3, The 
significance of the Items set uo within each 9-word File En- 
try Is as follows* 

1, Filename -la the 6-eharaeter name for the file as 
described in section 4*1,1, etpred aerosi two words 
in 1 of t- J ust 1 f 1 ed Padix-S0 format (aee seetlon 
5.3). 

2, Extension - Is the 3-eharacter suffix to the 
file-name also described In section 4,1,1 end simi- 
larly atored In Radix-50 In one word, 

3, Date - Is extracted from the low-order 12 bits of 
the value currently stored in the Monitor 3VT by a 
kevboard DATF command (see seetlon 4,4,1) at the 
time whan tha file was created* 

4, Tyne - la presently used to discriminate between 
linked and contiguous files (0 l 1 neseeet 1 vel y) • 
the remaining three bits of the sameword are res- 
erved adainst the eossible future introduction of 
ot^er file tVDes. 

5, Usage count • covering 6 bits, is set to 77 when 
the file Is ooened for creation and prevents the 
opening of the same file for any other purpose un- 
til it has bean completed. The count is then reset 
to 0* The remaining eaoaeltv of the six bits 
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( 1 — 763 Is provided to enehle the usage of the same 
f 11 e-at rueture In anv future operating system el- 
lowing more than e slnole user. It would then be 
neeessarv thet the Monitor for the system should 
know how many users were currently working uoon a 
file In order to prevent Its deletion or modifica- 
tion while still In use. (This feature Is not Im- 
plemented under DOS because it Implies that ever v 
.CLOSE uoon a file (even though this was opened or- 
iginally for Input only) reoulres directory 
eleen-up action. This obviously takes time partic- 
ularly on DECtape, It Is not therefore deemed wor- 
thwhile since, it merely protects the single user 
against hlmsel f ) . 

6. Loek • using 2 bits. Is set to 1 whenever the file 
is open for extension or update to prevent further 
opening for the same ouroose until the first opera- 
tion has been completed. The file may still be 
opened for Input only during this oerlod, however, 

7 . The remaining bits In this word of the entry were 

originally reseryed for the storage of the 

date-mode of the file content (as described under 
.REA0/.49ITE in section 3,2,2). This was not Im- 
plemented In. order to allow files of mixed mode da- 
te. These bits ere now spare, 

8, Start - shows the device address for the fleet 
block allocated to the file end for a linked file 
thus forms the start of the file bloek-ehein, 

9, Length - Is the number of Physical blocks covered 
by the file and basleallv enables control of random 
aceess of contiguous files. 

Ifl. End - shows devlee address of the last file-block, 
a necessarv reouirement for Joining linked files, 

11, Protection code - is the eiqht bit value by which 
file access can be denied to unauthorized users and 
which Is described more fully in section 4.1,4, 
(The remaining bvte of the same wond Is currently 
spare. ) 

As noted earlier, the first UFO block Is allocated to a user 
and Is linked to the ,aoproori ate word of his MFD entry when 
he creates his first file. The bloek Itself is cleared end 
Its first _entry slot is then reserved for the new file. 
Subsequent files are associated with the first available 
empty slot within the UFO until no more remain. *t this po- 
int a further block Is added and linked to the UFO "file" 
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and la cleared for linjlar aetion. It should ha noted that 
when a ntw linked. file is to be canted* an Initial antry of 
Filename*. Fxtansion* Date and File start block la wads whan 
the file is ooaned, This both reserves th« directory slot 
and oreventa the opening of another file bv the. same name. 
The res? of the entry la completed when the file is eloaed. 
If a file la delated* only the first three words of Its di- 
rectory slot, <*e* its none end extension* ere removed as 
this la sufficient to free the slot for further use* No at- 
temot la made* however* to return completely emoty >JFO 
bloeks to the free apace on the medium. 


4*1*3' Bit Maos 


The mechanism bv whleh the Monitor controls the allocation 
of the individual bloeks on a medium la a bit map In which 
aaeh bit represents one block. The bit la set to 51 until 
the. eor resoondl no block has been aaaioned to some file. when 
IT is reset to 1* As with directories* a master copy of the 
bit mao representing the whole available medium is stored 
uoon the medium Itself* 

The sice oftha complete mao for anv Particular medium Is of 
eourse .a function of the overall size of the medium Itself 
and varies between davlees* It follows* however* that on 
all but the smal 1 -eaPae 1 t v media more than one deviee block 
la needed to store the full map. Moreover it would obvious- 
ly bo unrealistic for the Monitor to have all of It In core 
for f i 1 e-procesal ng at one time. The map Is therefore di- 
vided Into sedments* eeeh of which occupies one deviee bloek 
and only one segment need be available in core at anv In- 
stance* This multi-segment structure was selected* rather 
than anpthar schema. In which the overall mao size Is con- 
stant for all devices and Individual bits eover a group of 
bloeks* not Just one* because It offers the following advan- 
tages t 

1* Wastage of the medium Is kept to a minimum (half a 
block on average per file) 

2, By restricting file operations to a compact area on 
a medium covered bv the single segment allowed In 
eore* greater efficiency Is obtained, especially on 
moving-head disks 

3, Control of allocation end of bloek Interleaving Is 
relatively simple. 

For the sake of dev 1 ce- i ndeoendence# the size of a mao seg- 
ment is constant for all devices and is based uoon the eaoa- 
eltv of the smallest block-size* namely *4 words. Figure 
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4-6 shows that the format of th» resulting segment includes 
• four-word preamble# the purpose of which Is Indicated be* 
1 owl 

1, Link to nest block • Implies that a complete medium 
Mtmmao Is eoeln e form of linked file and might as 
a result be stored anywhere on the medium. In 
oraetlee» however# the Individual blocks are con- 
tiguous and are aenerallv set up during initialisa- 
tion at the hlah-address end for reasons to be div- 
an In seetlon 4,2, Currently also the map-file 
eennot be extended to cover an increase In the ca- 
pacity of the medium as It has been assumed that 
anv such Increase will normally be followed bv a 
compl at ere i n i 1 1 al 1 sat 1 on which will rebuild the 
whole bit-map afresh. It should be noted# too# 
that because random-access capability Is needed# 
Particularly for file deletion# an index of bloeks 
used for the bit mao Is stored In the first M FD 
block as Indicated In the orevlous section. This 
Index# rather than the links# may be used In some 
instances for sequential access as well* 

2, Mao number - Is needed to allow computation of the 
range of the blocks represented by the mao segment# 
using algorithms like the one following (based on 
numbering from 1 ) t 

HIGHEST BLOCK a (w A p SIZE X 14 V **P M) • 1 

3, Mao size - gives number of words actually used by 
the mao since some devices (oart 1 cul ar 1 y DFCtaoe at 
present) may not need the whole of the segment of 
constant size for their complete mao. This Infor- 
mation Is therefore reoulred for the above computa- 
tion, It is constant for a given deylee - If all 
words In the lest mao segment ere not reoulred# 
they are all set to 177777, 

4, Link to first block - is provided to enable the 
Monitor to apply the Philosophy mentioned In the 
previous section - that of keeping linked files as 
far as possible at the front end of the medium. 
This 1 mo 1 1 es that whenever th e mao segment current- 
ly In core shows that no more blocks are available 
within Its area# the search for another free block 
for a linked file must always revert to the start 
of the mao In case some earlier blocks have been 
released by some recent f 1 1 e-del et 1 o- • This link 
facilitates the oroeess. 

The remaining 60 words of the segment form the mao Itself# 
eoverlno 960 Blocks on the medium. The numbering of the 
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bits within each word 1* from right to left. Thus the fo1» 
lowina simple algorithm suffices for the conversion of a re- 
lative Meet* number Into the mao position of Its representa- 
tive bit! (assuming Bloek 0 ■ Word 0# Bit 0) 

1, M*p word ■ Block/16 

2, Bit position In the word • remainder 

As mentioned above# the bit-mao structure is established 
during medium-1 nl 1 1 al 1 zat 1 on. At this time the whole map Is 
cleared to 0 with the exception of the bits whleh reoresent 
blocks already allocated for the Mpo# The map Itself and 
perhaos. the System and Its UFO, In the last mao seoment any 
bits for which there are no eorresbondl nq blocks are also 
set to 1, In general# thereafter# as a new file is created# 
the Monitor reads an aooroprlate segment Into core# unless 
one la alreadv there for some other ouroose. The relevant 
bits for blocks asslaned to the file are sat to 1 In the 
eore seament while the file, ia being bullti when It Is 
closed# the eore segment is rewritten Into the master copy 
on the medium. If the file la later deleted# its assigned 
bits are reset to 0, 

4,1,4 File Protection 

During the introduction to this chapter# It was stated that 
any fllerowner expeets to be protected against the corrup- 
tion of hia files either by himself or other users sharing 
the seme medium, in faet he probably also wants to control 
the form of access those other users have to his files. 
Moreover he may naturally wish to give greater privileges to 
those with whom he Is closely associated in his usaoe of the 
svstem than all others. 

Figure 4-7 illustrates an eight-bit code by whleh the user 
can indicate his requirements for eeeh of his files. The 
purpose of each of the three fields shown Is as follows! 

1, Owner! the user himself can# in general# always ac- 
cess his files In anv manner he ehooses (e,q, 
Peed# Write# Delete# etc.). However he is afforded 
two safeguards represented by the bits In this 
field. By setting bit 6 to 1# the user can denv 
himself Write and Delete capabilities In order to 
nrevent accidental corruption of his data. With 
bit 7 at 1# he can protect the file against auto- 
matic delation bv the system when he logs off the 
co-puter ( a feature not yet Implemented In DOB), 

2. Grguoi this field can be set to a three-bit eode bv 
which the user indicates the level of access he is 
prepared to allow his "friends"# l.e. those who 
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have the seme UIC qrouP number as himself. The 
codes eresentlv assloned arel 

7 ■ no access at *11 

5 ■ run access 

3 ■ read access 

1 a write access 
ft a delete access 

At any level, of course, the inclusion of higher 
levels Is implied, For example, with protection 
set at code 1, the Monitor will allow a "friend" to 
write, read and run the file, but not delete it, 

3, Others* this field can be similarly eoded to show 
the level of aceess allowed to users outside the 
owner's orouo. 

As indicated in section 4.1.2, the resultant byte Is stored 
In the_ file entry in the UFD when the file is established. 
The Monitor always checks every reaueat for aceess against 
the stored eode (see section 4.4.2), The u*«n can change 
the code at any time either directly from a prooram using a 
,RENAM or .KEEP reouest described in Section 4,6,4 on 
throuoh the /PE on /P P switches available In ®Ip*11. 

It ahould aoaln be noted that the pnotection offered by this 
code ean be valid only when eveny user sharlnq the medium is 
penfonmino all his I/O operations within the f i 1 e*at rueture 
framework, l.e. by .READ, .WRITE or .BLOCK, The Monitor 
eennot and will not deny aceess of anv sort to a user re* 
question .TRAN (even to Its own files). 
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4.2 Application By Device 

The overall philosophy for the DOS f 1 1 e-st ructure, described 
In th* previous section, provides for ©Derations which can 
b« dev 1 ee- 1 "dependent to some considerable degree end this 
eoneeot, has been honoured as far as possible in Its Imole- 
mentation on all disks and DECtaoa. Nevertheless, thane are 
obv1ous,.probl ems In rigid adherence to It at everv point be- 
cause. of the nature of the devices themselves. This seetlon 
therefore Illustrates the detailed application of the 
f i 1 e-at rueture and In particular Indicates variations from 
the norm. 


4.2 . 1 Fixed-head 01 ska 

Although the RFll disk is basically word-oriented. DOS im- 
poses a bloek structure based on 04 words to a block, with 
the drlyer providing the neeesserv address-convers Ion, The 
RC11 disk driver always assumes a similar block size and In 
response to eeeh system request for a bloek. transfers the 
appropriate double 32-word seetor accordingly. Furthermore 
the addition of extra platters to either controller merely 
extends.the continuous surface available to the system (pro- 
vided of eourse that the user has Physically assigned all 
his platters in e. strict aaeendinq sequence from 0). To all 
Intents end ourooses. therefore. R^ll end OC11 systems 
differ only In their overall eaoaelty and henee the number 


of bit-mao bloeks 

needed to 

control this. 

The following 

table shows the correspondence! 



PLATTERS 


blocks 

BIT HAPS 

1 

X RC11 


1024 

2 

2 

X RC11 


2048 

3 

3 

X RC11 


3072 

4 

4 

X RC11 or 




1 

X RF11 


4096 

5 

2 

X RF11 


8192 

9 

5 

X RE 1 1 


1288 

13 

4 

X RR11 


16384 

18 

The basic format 

for either 

disk, 

when not 

In use as the 

system device. Is Illustrated at 

figure 4- 

8, This shows In 


particular that the requisite bit-map blocks are In a con- 
tiguous area at the Moh end as was noted In section 4,1.3. 
They are stored here for two reasons! 

I, fly their nature, thev must be updated and should 
not be In anv potentially write-locked area - the 
too of the disk is the least likely oart to be pro- 
tected. 
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2, The toD of the disk on the other hand is th# normal 
olgee for the storage of contiguous filet • the bit 
*ao blocks are thus compacted to keao them out of 
the wav. 

The question of wr i te-proteet ion introduces smother dissimi- 
larity between the two tyres of disk whan used as 
system-deviee* The hardware facility o" both provides e set 
of switches with eaeh switch covering a particular area of 
the disk surface. The area however is not th# same. For 
reasons stated in section 2,1,2# DOS dees not eurrentlv al- 
low the use** to apply any of these switches. Nevertheless 
to megt the, future possibility that the Monitor Itself might 
be wr 1 te-orotected# the t 9 P of the are# reserved for its use 
hfs been set to coincide with an appropriate switch. On 
figure 4-9#, which gives the layout of a system disk# a 
Hardware Protection Line has been shown cor resoondi ng to* 

1, End of bloek *777 on PFU (aouivelent to word 
#77777) 

2, End of bloek #437 on RCtl (equivalent to aetual 
block #1077) 

FI 1 e-orocess i no operations on both PFll and Roll follow the 
generfl outline given in the previous section. Linked file 
delation merits further comment here since this is one oper- 
ation handled differently on DECtaoe and disk, A oert of 
the process is the adlustment of the mester bit-mao to re- 
flect the blocks released bv the delated file. This can on- 
ly be accomplished by a search of the file itself to deter- 
mine th# relevant bloeka# ainee the general structure pro- 
vides for no other record of this. Sueh seareh also imolies 
that the link-words on the blocks themselves must be ne-ovad 
to safeguard against potential di sk-copruet ion later* for# 
should a orogram or.svatem failure occur# file# might remain 
ineomolete on th# disk and the results of deleting them in 
this w#v could he unpredictable. This search and link-clear 
obviously takes some time but it is not deemed unreasonabl a# 
because of the relatively fast disk access rnte end it avo- 
ids other complications to be diseussed in section 4.2,3, 

The interleave factor for linked files on both PFll and RC11 
la 5., , This hes been based uoon the optimal time taken bv 
the Monitor to complete the processing involved in loading a 
program from these disks. 


4.2.2 Moving-head Disks 


The on 1 v moving-head disk presently supported bv DOS is the 
RK11# though this oecurs in two versions - one high density# 
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structured into 480? sectors of 256-words eaeh, the ©thee 
low depsitv with sectors reduced to 128 words* For slmoll- 
eltv, both versions ere handled bv the Monitor In 2S0-word 
block*, the RKil driver aqein providing address-convers 1 on 
where reaulred. 

Unlike the fixed-heed dleke, the addition of extra &K-11 
eertridoes .cannot be treated at simple extensions of a eon* 
tinuous surface, slnee the user cannot be expected to retain 
the same set of Individually changeable cartridges together 
as an,entitv. Instead each must remain. an ingegendant unit 
with its own structure • and, In faet, is a different medium 
In the sense of the definition of a file given in the intro- 
duetlon to this chapter* As a result, thg number of bit 
maps to control tha eaoaeltv of an RKll disk Is always eon* 
stant* though of course there Is a difference between the 
two verslonsi 

HIGH DENSITY (4800 BLOCKS) ■ 5 NAPS 

L0K DENSITY (2400 BLOCKS) * 3 NAPS 

The layout of an RKll disk, whether used as the system dev* 
lee or not. Is otherwlga the same as that illustrated for 
the fixed-head disks at figures 4-8 and 4-9. In particular, 
this means that the bit mao blocks remain togsther at tha 
top of the disk, because this again allows thg user the mopt 
contiguous soaee for large random-aeeesa files* This is 
considered to be more important then the reduction of 
head-movement# whleh might follow if the mao segments wars 
dispersed aeross the disk, surface so that eaeh reside mere 
closely to its area of control* (This was originally 
planned - henee the linked-flle structure of the mao*) It 
should plso be noted that "hardware. protection line" as aueh 
Is meanlnolass for RKll* since this offers no salaetlva 
wrlte-lpck feature • It Js all or nothing* Navert hal ass# 
the boundary 1 t represents is the end of block 4277 whleh 
gives the Monitor sufficient reserved area for its oresent 
needs and some room for expansion* 

Flle-eroeesslng for R"ll again follows the outlines given In 
section 4.1 as ouallfled at the end of the previous section* 
The Interleave factor Is also 5 on the same basis as that 
used for RFl 1 and RCll, 


4.2.3 DECtape 

Although, In many ways, DECtaee can be eguated to disks in 
mode of usaoe to the extent that most f 1 1 e-orocesslng opera- 
tions can be truly device-independent. It ha* one serious 
draw-baekt it Is single-tracked and It is linear. It is ob- 
viously slower therefore and taoe-positioning assumes a mueh 
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greater s 1 on 1 f 1 cane*. On* minor effect ef this is that Dj- 
reetorv end bit mao blocks/ which ere Generally accessed In 
the sen* sequences should be keot reasonably close together 
rather than at ooooslte ends as on dick. This Is readily 
feasible when the overall structure allows allocation of 
these bloeks In any position end potential write-loeklno 
does not reoulre consideration# since this Is not selective* 

A second consequence is a modification In the format of a 
linked file. If a search for the nest free hi eek # reaches 
the end of the mao seoment currently In use# it is reason* 
able that this search be resumed from the start of the seg- 
ment on disk - but not so on DECteoe, Because of the physi- 
cal. tape, oosltlon# it makes more sense to us* the hardware 
facility for transferring In reverse. However# this facili- 
ty only effects the aeeess of the tapet at the core end# 
transfer is always forwards. This means that bloeks written 
backwards must also be read backwards. Henee It becomes ne- 
cessary to remember the tape transfer direction when the 
file is created. Sine* on* DECteoe contains only 576 bloeks 
of 256-words each# It Is convenient to use the link for this 
puroosei 


Positive link ■ read next block forwards 
Negative link • read next bloek backwards 

The search algorithm actual 1 y aopl led to DECtao* uses the 
fact .that when the_ tade is stopped by the driver after 
transferring a block forward# It Is appropriately Positioned 
for Immediate access to the preceding block fviee versa for 
a backward transfer). Thus this Is the point from which the 
search Is resumed. . Hence the format of a DECteoe linked 
file mlaht appear as illustrated In figure 4-10. 


sineeth* driver alwavs stoos the taoe between transfers# 
tape oosltlon Is also the basis for the Interleave faetor on 
DECtao*# presently set at 4. Owlnq to the time actually 
taken to bring the teoe to a standstill and later to bring 
It baek uo to normal speed for a transfer In the same direc- 
tion#. three blocks usually pass aeross the read-writ* heed. 
Oecaslonellv a fourth may also# especially If the 
brakl nq-mechen| am of the transport Is Incorrectly adjusted# 
and tape reoos I t I oni no is then neeessary.. However# the fre- 
quency of such occurrence Is not sufficiently high that It 
currently warrants an Increase In the IE when this might un- 
necessarily Impose some 5# milliseconds of ex$ra aeeess time 
for each block In almost all PEftepe l|nked-f!le operations. 

Llnked»f11e deletion was specifically mentioned in section 
4,2,1 because this Is one major area In whleh DECteoe Is 
different. The disk method was shown to be a matter of 
searching the file for its associated bloeks and at the same 
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tin* clearing the Hn^wopdi, nn OECtaoe tMi 4s out of the 
question! the sesreh alone might be • lengthy operation* to 
•eeess eaeh.bleek e second time to dear Its link-word, with 
tsoe reoosit ionlng eaeh time makes It Impossible. The only 
alternative 1* the Provision of a seeerete record to show 
the bloeks In eaeh file end the shortest form of this Is 
another bit mao* However* this then raises the problems of 
havfno severe! maps In eore at one time (the master for de- 
termlnetlon of block availability end one for eseh file eur- 
rentlv under ereetlon) end of their storage upon the DEC* 
tape* Both questions have been solved by Imposing the fol- 
lowjno restrictions on DECtaoe usage* whleh are reasonable 
In its ease but eould not be considered for disks! 

1* By, allowing only one file under erection at a time 
(not without sense. for practical operating consi- 
derations) the need for anv but the master bit mao 
in eore disappears. The file egpv can be con- 
structed from the before and after states of the 
master* Apart from saving eore»_th1s also reaulres 
less departure from the method of general process- 
ing - merely one extra operation while the file Is 
closed. 

2* By Imposing e maximum of 56 files on e single tsoe* 
the Individual file maos can be packed into a con- 
tiguous area of 8 bloeks (since eaeh block of 
256-words can accommodate 7 maos eaeh using 36 
words)* Moreover* this figure of 56 is also the 
eaoaelty . of 2 UFD bloeks on the basis of 28 9-word 
entries oer block. The moo for env file Is easily 
accessed by equating its relative position In the 
contiguous area to the relative position of the 
same f11e?s entry In the UFD. For example* the 
30th file in the directory haa Its mao stored as 
the second entrv in the fifth bloek of the map ar- 
ea. (It should be noted of eourse that the forego- 
ing need not apply to contiguous files* If any of 
these are established on the tape* their corres- 
ponding file maos are left blanks) 


The layout of a OECtaoe* allowing for the limitations des- 
cribed* Is illustrated at figure 4«li, It will be seen that 
the full Mpn/UFD structure Is provided. Basically* this ma- 
intains compatibility with disk operations* Tt also enables 
the perheos dubious facility of several users sharing the 
same tape. The UFO, of eourse* eannot be extended* In view 
of the restriction on the number of files, (Sinee OECtaoe 
Is not gurrfntlv a potential system device* there Is no cor- 
responding illustration.) 
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4,3 Fill Management 

DOS file management is performed by • set of uomitor modules 
whieh are ell ealled bv Fmt, each haying it* own unioue 
coda, However all of them have character i st ies whieh make 
than diffepent from the general I/O nodules discussed during 
ehaotep 3. The oupoose of this section is to examine these 
eharaeter i at i es and then to diseuss their eommon interface 
channels, Jhe individual modules will he described in fol- 
lowino Sections. 

All the modules concerned are listed with their E^T codes in 
figure 4-12, They are shown to fall into one of four cate- 
gories! 

1, Modules ealled directly from a user program to per- 
form f i 1 e-housekeeoino functions* e.g. .ALLOC* 
• DLETE * etc. 

2, Modules ealled bv other Monitor routines* perform- 
ino general I/O ooerations such as ,0 p EM* in order 
to provide f i 1 e-handl i ng, 

3, Modules called generally bv other f i 1 e-m«naaement 
modules to earrv out eommon operations sueh as di- 
rectory searching, 

4, Modules specially associated with other modules in 
the f i 1 e*menagement set. 

This grouoing illustrates one obvious difference from the 
general I/O modules* only those in the first category are 
immediately accessible by a user. These of course* being 
I/O modul as themselves have E M T code* in the range 0-27 as 
the ljst shows. They have Prescribed calling seguences* 
described. jn_ the P roor ammer 1 s Handbook* which include the 
paesing of information on the processor stack and this must 
be removed before the user program is recalled. On entry 
from the EmT handler* the stack too contains the contents of 
the program Registers as described in section 2,2* these 
must be restored on exit. Actual Register contents passed 
bv the fMT handler are especially relevant to t^ese modules* 
in part i cul ar * 

Rfl » address of the DOB for the 
dataset being serviced 
R1 ■ address* on the stack* of the eall 
parameters passed by the program 

The modules in categories 2 through 4 ©n the other hand are 
invisible to the user as indicated by their EmT codes. In 
the Programmer’s Handbook these are shown as reserved for 
system use. They are not in the I/O range since the mo- 
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dules, thouoh still performing I/O, are called et a second 
or even third level within the Monitor and the requisite in- 
formation has already been supplied at the first level. 
This feet also eauses other ehanqes In the call and exit In* 
terfaee as fol lows* 

1. Calllno sequences need follow no definite format. 
Transient Information mav thus be transmitted ei- 
ther through the staek or the Registers, whichever 
is more convenient to the modules beino called, 

2, If the Registers are used, the called routine still 
receives the data on the staek, as saved bv the EMT 
Handler. (A typical staek following a eall la il- 
lustrated at figure 4*13,) 

3, Unless the Interface requires it, the saved Regis- 

ter contents must be. restored intact to the calling 
routines. This applies In particular to categories 
3 & 4. Modules In eateaory 2, In fact, exit di- 

rectly to the usert they therefore eetually remove 
the Register contents end the saved eall PC and 
status In order to produce th# staek state for such 
exit. 

4. Contents of Register# on„entry from the FMT handler 
in general have no s ign 1 f i eance. 

A less apoarent difference between the f 1 1 e-manegement mo- 
dules and the others arises from the fact thet thev still 
provide program services. The user ean therefore select 
between making them resident, either Permanently or Just for 
a proaram run, or leaving them to be swapped in when re- 
quired, For this purpose, he is informed of the existence 
of all of them • even If they are shown onlv as subsidiary 
routines in Appendix C of the Programmer's Handbook, if he 
chooses residency, there is no problem. The swapping situa- 
tion .however Is another matter. In reality, modules In ca- 
tegories 3 8 4 serve as subroutines providing special func- 
tions for the others but they cannot he brought Into the 
Swap Buffer for this Is still occupied by the calling mo- 
dules in cateaorles 1 and 2, The solution is that the 
latter obtain another 256-word buffer from free core, via 
the Monitor 8.GTB routine described in section 2,4,2, and 
move themselves Into It, This then leaves the Swap Buffer 
free for the ealled routines to use In the normal wav when 
required, as described in Section 2.3. 

The actual mechanics by whleh this operation is managed des- 
erve further explanation. In the first place, the move-out 
must only occur If the category l or 2 module. 1* actually In 
the Swap Buffer and not already resident outside it, for ob- 
vious reasons. The module must Itself resolve this and It 
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uses the feet that the Usage-Count In its first bvte ean on- 
ly be 0 if it has not received control through Swao Area 
Manager, (in much the same wav that the other modules des- 
cribed in chaoter 3 detemi ne. t hei r exit seguenee), If the 
count is non-0, the extra buffer is obtained and the -eve is 
accomol i shed, as illustrated in figure 4-14. Curing the 
move, due regard is taken of the Dos i t i on- i ndebendent nature 
of both buffers. In addition, the first word of the routine 
when stored in the new buffer is used as a eounteri this 
must start at 177401 (or -1,1) since, as an overlay# the 
routine eennot be re-entrant and henee is only once ealledi 
it ends, at 1 after the move and thus still indicates 
non-residency. The routine then clears the first word of 
the Swao buffer to free it for further use and. continues 
from its new location. On exit, the extra buffer must be 
returned to free core! however, the routine eannot do this 
while it is itself still in the buffer. Therefore when the 
tlsaoe Count (as noted above), shews such aetion to be neees- 
sarv, the routine simulates a cell to the Monitor S.RLB 
sub-routine bv ©lacing the system exit address (without Us- 
age-Count decrement) on top of the stack and bv then using 
JMP rather than JSR, 

The following paragraphs describe the data areas especially 
established for the transmission of file management data. 


4,3,1 User Pile 8 1 oc k 

All user program* calling for f i 1 e-management ©Derations, or 
for aenera) I/O whieh might lead to such operations if the 
device is right, are reouired to supply file information 
throuoh a User Pile Block (UpP). This is described in deta- 
il in chaoter 2 of the Programmer's Handbook, Briefly, as 
shown in figure. 4-15, this allows the user to indicate his 
purpose an© identify the file reguired, including its owner, 
(if not himself), and to, establish its protection,. It also 
provides room for the Monitor to return error information 
and an exit should such error occur. 

The address of this File-block is passed as one of the pro- 
gram cell Parameters and the Monitor routine uses it to ac- 
cess it* contents as reouired. However, as indicated in 
section 3. 1.2. 2, the user can suoolv different file informa- 
tion via a keyboard ASSIGH co-mand, If he has done this, 
the ,TNIT routine saves the address of the relevant entry in 
the DAT. pointer in the dataset OOP as noted in section 
3.2. 1.1. The file-management routine therefore checks sucH 
entry and uses its contents if valid (see LUK in section 
4.4.1) 
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4.3.2 Pile Information Block 


It Hat already been mentioned that the f i 1 e-manaqemant mo- 
dules can uaa the stack or Registers for trans-itting tran- 
sient data between one another. More permanent data which 
must he held across several requests requires different sto- 
rage, Suehdata. being applicable only to the dataset being 
serviced# is imoure and is therefore similar to that stored 
in the OpS for aeneral I/O orocessing. As shown in Section 
3.1.2. the sice o* the OOP itself is set to cater only for 
the general need; f i 1 e-manaoement reauiras additional soace 
end this is provided in a F i 1 e-In format i on Slock (FTB), 

Ffgure 4-ie_shows the FIB formet. Basically this, is de- 
signed to follow a sequence eor resoondi no to the file entry 
in the UFO. It will be noted, however, thet the file name 
itself is not included. This is unnecessary for a file 
whieh already exists; for e new file, es noted in Section 
4.1. the need is removed because the entry is stored on the 
medium fa soon as the file is ooened. Other items do aooear 
to avoid unnecessary access to the medium. The puroose of 
eaeh item is described below* 

1, Next Block • is provided mainly for the creation or 
extension of a linked file, since the allocation of 
the next block muat occur before the current one 
(or the UFO in the ease of .OpEND) cun be written, 

2, How Open Code • is used to transmit the appropriate 
content of the UFB between orooram requests, since 
the latter is only accessible during .OPEN, (see 
Section 3, 2. 2.1). 

3, Extension start block U - saves the beoinninq block 
following .OPENE. To protect the user against fai- 
lure end also allow alternative use for inout at 
the same time# a file beina extended is left in its 
original state until the extension is completed bv 
•CLOSE, This item therefore is needed to enable 
the "APPEnO" operation which oecurs at that time, 

4 , Type - corresponds to the similar entrv in the UFO 
file entry ind is discussed in Section 4,1,2, 

5, Spare, 

6, Start block * - always contains actual file start 
block even durina extension (hence 3 above) 

7, * of blocks - is used as a counter durino file cre- 
ation or extension (starting from the original 
length in the letter ease) and eventually is stored 
in the UPD as "Length", 
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3, Pnd bloek * ■ stores the present end of a fll* 
under extension ■ otherwise Is normally unusad un- 
til a new file Is closed. 

9, Index Into Directory Bloek - shows the relative 
oesltlon of the file entry in the appropriate UFO 
Bloek (see next). 

IB, Directory bloek 4 - enables Immediate access to the 
aetual devlee bloek on whleh the UFn entry for a 
file under creation or extension aopaars and thus 
removes the need for a fresh directory search on 
.CLOSE. 

11, Protection Code - shews the file's protection lev- 
el . 

12, Interleave factor - saves the content of the cor- 
responding entrv In MFD block #1 as described In 
Section 4,1, 

13, Bit mee Pointer - contains the address of the 
buffer in eore. in which the appropriate medium 
bit-map segment is loaded (or is currently held 
see next). 

14, Bit mao Q link • enables the opening of several new 
files (on different datasets!) on the same medium 
at the same time. For reasona stated In Section 
4.1, only one bit map segment from a medium can be 
in cope at any one Instance, Thus several files 
must share the same segment. To allow this, the 
appropriate FIBs^ere chained (as shown In figure 
4-17) starting from an allotted word in the device 
driver standard Interface table (see Section 
3.3,1). When the first file requiring a mao la 
opened, the mee seqment Is loaded Into a buffer 
elelmed from free core and the driver pointer to 
the concerned FIB is set. Subsequently FIBs are 
linked and unlinked as their associated files are 
opened and closed. When the last file Is finished, 
the driver word becomes B again and this Is used to 
slanal the release of the mao-buffer. 

15, Temporary workspace - is used malnlv durina file 
ereatlon or extension by .write (see Section 4.5.2) 

14. Temporary workspace - same as 415, 

The FIB Is set up In a buffer claimed from free core via the 
Monitor 3.GTB routine. only If file- management operations are 
called. For rnormal f i 1 e-orocess 1 nq this Is done by the gen- 
eral .OPEN routine (see Section 3.2.2, 1), Housekeeping rou- 
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tinea elain their own, (In feet# ainee the latter* In gen- 
eral# comolete all their reaulred functions In one user oro- 
gram reoueat* the FIB Is not really neeesaary. However for 
epneet 1 H1 1 1 v of oroeeaalng especially by the eomnon subrou- 
tines and to provide additional workspace It Is still set 
up*) While the FIB Is established* It is accessed through a 
pointer In the last word of the DOB (see figure 4«16 and 
section 3, 1,2,3), It Is released as soon as it has served 
Its purpose* e , a , on .CLOSE, Its DOB pointer then Is 
cleared and Its buffer Is returned to free core via S.PLB, 
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4,4 General Purpose Routines 

The ogrpaie of this section Is to describe those 
f n*»"iin«aei"«nt modules which aet es sub-routines providing 
services generally reouired by the other modules* such as 
di rectony-searchlog* collection of a bit-mao seflment or al- 
location of a new bloek, (Cateaory 3 In Section 4,3,) When 
non-resident, thev operate from the aenerel Sweo Buffer, 


4.4.1 Olrectorv Seereh (LUK) 

The function of this routine Is to oerform a directory 
search for e filename to determine the presence or absence 
of a oartieular file on disk or DECtaoe. 

Celling Seauenee! 

MOV *FILBLK , - (8P) 

MOV *LN*BLK,-(3P) 

MOV 3P*P1 

SUB *14. SP 

E*T 4fl 


R0 • Address of^the DOB 
R 1 ■ (A0DR-?) of Pointer to UFB 

The cellen must subtreet 14 from the stack pointer 
for the routine's return arguments. Note* that 
this routine does not remove the arguments pushed 
onto the stack in the above celling seauenee. 

Return Arguments! 

(R6)»X ?X DECODED BELOW 

2(R6)«FILE 
4(R6)«NAME 
6(R6)«EXT 
10(R6)«UIC 

12(P6)»PC0DF fBROTFCTIOM CODE 

X«-l If the UIC was not entered Into the MFD DDB+4 
will contain a zero uoon return. 

X«-2 If the file dirt not exist In the UFD* 0DBt4 
will contain a 0? DOB+2 will be m if no emotv 
slots In the UFD or will be the UFD block number 
which has an empty slotj DDBt22 will be the In- 
dex to the emotv slot. If the named file was 
00,0, A -2 will be returned also. In wMeh case 
DDB+4 will be unchanged. 
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X«-3 If there no UFO attached to the MFD en- 

try, iJoon return ODB+4 will contain the bloek 
number containing the MFD entry, DDB+2 will be 
a#t to the address of the UFD pointer within the 
MFD, 

X"other then above • then it is the eore address 
of the UFD entry. DDB+4 will contain the block 
number of the UFD entry* the bloek eontainino 
the JFd entry is in core. 


Description* 

This routine executes entirely in the Swap Buffer (MSB)# un- 
less it i* made eore resident. When this routine is en- 
tered* the stste of the stack is as follows* Registers 0 
throuoh 5 are saved on the too of the staek, then the PC and 
PS* and then a 6-word work area for the return arguments, 
R0 and PI ere restored from their saved values on the stack, 
Rl is then set to point to the User File Bloek# end R2 is 
set to point to the 6-word work area on the staek, The user 
file block is then moved onto the stack as! file name* ex- 
tension# UlC# end protection code. If there was en assign- 
ment made* the assigned name is moved in. If there was no 
UlC in the file name block* the UlC is taken from absolute 
location 440* which is the looged in UlC, If at this ooint 
the file name is 0 fl ,0# a -2 is out on the orevioua top ef 
the staek end the routine returns to the caller through the 
common exit routine# S.EXIT# at absolute location 42, 

Now, the routine gats the block number oi the Mfd from the 
device driver. The first MFD block is then read into core. 
If the deviee is DECtape the first Mpo block is skipped 
sinee this does not contain UTC|s and would require an unne- 
cessary time expanse. The routine then scans the MFD block 
looking, for the desired UlC. Reading in MFD bleeks contin- 
ues until none ere left or the UlC is found. If the UlC is 
not found* a -1 is out on the previous too of the staek and 
the common exit is taken baek to the caller. When the de- 
sired UfC is found in the MFD a test is made to see if a UFD 
exists for the UlC. If no UFP a -3 is out on the previous 
toe of the stack and the common exit is taken baek to the 
caller. 

If a UFD does exist for this U I C the starting block number 
of the 'JFD is out into the.DDB and the first UFD block is 
reed into core, Mow the routine bed i ns scanning the UFD for 
the desired file name and extension, UFD blocks continue to 
be read in and scanned until the end of the UFD chain is re- 
ached or until the file and extension ere found. If the end 
of the UFD is reached without a match# a -2 is out on previ- 
ous too of the stack and the routine exits as previously 
described. If the scan is successful end a match is made* 
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the core address of the UFO entry Is out on the previous too 
of the staek and the eo-mon exit Is taken. 

Notal tha directory LOOKUP routine has an Imbedded 
READ/WRITE routine and also uses a common exit routine 
throuoh absolute location 42 which restores the stack to Its 
state before the E M T request. This does not modify the re- 
turn arouments on the stack. 


4.4.2 Cheek Access* Set-up and Release FIB (C*x) 

This routine is a three part utility Program which performs 
the following functions* 

1 - CHECK ACCESS PRIVILEGE 

2 - SFT UR FILE INFORMATION BLOCK 

3 • RELEASE FILF INFORMATION SLOCK 

The EMT codes for the three functions are the seme# EMT 52* 
byt to. e«l 1 the Individual function a 0* M# or -t respec- 
tively Is pushed onto the staek. The routine will then die- 
pateh to the proper segment# within the file structure mo- 
dule, The {hose segments are Individually described In the 
following discussion. 


4.4.2. 1 Check Aeeess Privilege 


The function of this routine Is to determine the permitted 
READ/WRITE aeeess Privilege of the caller. The ealler must 
request the level of access he desires. Then this requested 
aeeess Is eompaeed with the file protection level, Tha re- 
quested aeeess Is then either granted or denied. 

Calling Sequence I 

MOV UIC*-(P6) 

MOV PC00E#-(P6) 

MOV *ACCESS*-(R6) 

CLR -(R6) I ZERO INDICATES CHECK ACCESS CALL 

EMT 52 

ACCESS LEVELS* 

2 • Delete 
1 - Write 

3 - Read 
5 - Run 
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R0 ■ Address of DOB 
Return a rouments ! 

C R6 5 »0 desired access permitted 

(R6)"non 0 desired access denied 

Dese r ipt 1 on t 

When the section of the routine Is entered# the stsek state 
Is as follows! Saved Registers R0 through R5» PC end PS, 
Function indicator and eallino arguments, R3 Is set to the 
desired aeeess, and R5 is set to the oroteetlon code, from 
the values oassed on the stack. 

The level of access to anv file la detenmined by the owner 
when he sets its protection as described in Section 4.1.4. 
The eheck access routine determines whether the desired ae- 
cess bv anv user shall be eermltted or not In the following 
manner. The routine first checks to sea if the caller Is 
the file's owner, bv eomparlna the 1o9oed-1n »J I C against the 
UIC calling argument ion the staek. If he Is the owner then 
bit 6 of the oroteetlon code is testedf If It Is set he can* 
not write on or delete the file, he protected his file aga- 
inst himself. Bit 6 being not set gives the owner eomolete 
access. 

When the ealler Is not the owner a second test Is made to 
determine if the caller Is in the owner's group. Thev are 
In the same group If their project number is the same! this 
Is the high order bvte of UIC. If they are In the same gro- 
up the geeess desired. Is compared against bits If 4, and S 
of the file's protection eode. If not in the seme grouD the 
access desired is compared with the low order three bits of 
the Protection eode. If the Protection code is hlaher than 
the desired access reauested then access is denied, and a -1 
will .be returned on top of the stack. If the protection 
code is eouel to or lower than the reouested access then ac- 
cess Is granted, and a 0 will be returned on top of the 
staek. Then the routine returns to. the eellen throuah the 
common exit routine, and the top of the staek holds the re- 
turned value, 0 or -1. 

Aeeess Levels 

Bit A Set - Hwner ean't write 

Protect Code greeter then 1, others can't write 

Protect Code greater than 3, others ean't nead 

Protect Code greeter than 5, others can't nun 
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4. 4. 2. 2 9ct»up F<1» Information Block 


When this routine la ealled a FT8 may or may not be attached 
to the 000, Therefore the routine hag a two fold function. 
One function Is to get a DATA BUFFER AND A FIB BUFFER from 
free core, when neeeeaarv. This function ia deaired when 
celled by routlnea other thanFOP (FILE OPEN) and FCR (FILE 
CREATE). The second function this routine Performs la to 

set un the FIB and link It to the DDB, This routine also 

seta the address of the data buffer. In the BOB, It la na* 
canary tp set up the FIB when ealled bv anv Hie structures 
routine including FOP and FCR, The FIB is set up primarily 
bv transferring data to It from the files UFO entry. 

Cal 1 1 ng Seauence! 

MOV #1,«(P6) 

EMT 52 

RB • Pointer to DDB 

R2 ■ Pointer to the File's .UFD entry In 
core. This 1$ necessary, when the 
routine Is called* to set up the FIB 
and link it to the DDB, 

Return Aroumentsi 

DOB+26 contains a non-zero value If the FIB was successfully 
setup. . The value Is the cere address of the FIB associated 
with this DDB, 008+26 contains a aero when the FIB was not 
sueeessfullv set up, 

Deseript 1 on* 

when this section of the routine is Initially entered, the 
state of the stack Is the same as described under the "Check 
Access" section, with t he . except 1 on of the eell arguments. 
This section sets uo R5 with the FIB Link Word from the DOB, 
Then, If there Is a FIB already, R2 Is restored as the po- 
Inter to the File's UFD entry. 

When 9ETU P FIB Is entered the FIB link word of the DDB Is 
tested to determine If there Is a FIB, attached to this DDB 
or If it will be necessary to get a buffer for a FIB and 
link it to the DDB. A zero FIB link Indicates no FIB* when 
this occurs the fol 1 owl ng procedure Is followed. The driver 
address is determined from DDB -2* the Standard, Driver 
Buffer $1*e Is gotten from the driver, as the number of 16 
word units necessary. This value Is saved and then this va- 
)ue Is used to calculate a word count, which is put In the 
DDB. The number of 16 word units Is Incremented by one to 
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Inelud* a buffer for the FIB, a eall is then mad* to the 
monitor* buffer allocate routine (GETBHF ) , reoueetlno the 
number of 16 word unit* desired. The 6ETBUF routine 1* 
celled through absolute location 54, The first 16 words of 
the returned buffer ere linked to the ORB as the FIB buffer* 
and the 16 words are cleared. The Data Buffer Is then 
linked to the DD9 at DDB+6# transfer buffer address word. 
Now the routine looos beck to the Initial test upon entry to 
this routine and will now find a FIR attached to this DOB, 

Whan a FIB is attached to the DDB the following oeeurs. 
Information concerning the file Is transferred from the UFD 
entry to the FIB, The transferred information include* the 
Next Block. Number which is also the First Block* the File 
Tvpe* the File’s Start Bloek Number# the File Lenath In 
blocks*, and th* File's Last Block Number, Then three more 
Items are set up In the FIBt the Index Into the directory 
block* the directory block number and the protection eode. 
This routine then exits beck to the caller through the com* 
mon exit routine# S.FXIT. Th* Information used to set up 
the FIB is in eore when this module la called. 


4,4. 2, 3 Release File Information Bloek 


The function of this routine is to unlink the FIB from the 
FIB. chain end release the FIB Buffer* the Data Buffer and 
also the Bit Map Buffer If no more FlB»s ere §ttached to the 
DDB, The FIB chain must remain continuous after th* FIB Is 
unlinked. So therefore a FIB pointer muat be reset. 

Cal 1 1 ng Seaueneei 

MOV SPC#-(R6) 

EMT 52 

The Instruction MDV #PC#m(R6) pushes e nega- 
tive number onto th* stack* A Neqatlve 
number Indicates a cell for release FIB, 

Return Arguments* 

Non* 

Although the FIB LINK In the DDB Is eleered* and the associ- 
ated bit mao la released# If this 1* the only FIB In the 
chain. 
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Description* 

Uoon entrv# the state of the stack Is the sane as for a 
"Setuo FIB" call. 

When the Release FIB routine is Initially entaPed the status 
bvta ofthe DDB Is tested to see If the Dataset Is currently 
busv#,bit 7 sat* If tha Qatasat is busv tha routine returns 
Immediately to tha eeller through the eemmon exit routine# 
8.EXIT, with no aetion taken. If the Dataset was not eur- 
pentlv busy an index into the devlee driver Is calculated to 
point at the flpst FIB link, of the FIB eheln foP tMs dev* 
lea unit. If the first FIB link Is sere# thane is no FIB 
chain fop this unit. In this case it Is only neeessapv to 
release the Data 8uffep and the FIB# which Is done through a 
call to the monitor# buffer release routine. Then dear 
their pointers from the DDB. The routine than returns to 
the ealjer through 8, EXIT. If the first FIB link In the 
driver Is non-sero the FIB link In the DDB Isthen tasted to 
saa if there is a FIB attached to tha DDB, If no FIB Is at- 
tached to the DOB release the Data Buffer# unlink It from 

the DOB and exit back to the ealler throuoh 8, EXIT. If the 

DDB has a FIB attached# it Is tested to see If It has a bit 
map attached. If the. FIB haa a. bit map attached to It and 
it la .the last FIB in the chain# tha bit mao buffer Is re- 
leased through a call to the monitor buffer release routine. 

If the FIB has a bit map but is not the last FIB in the cha- 

in# the FIB la merely unlinked from the chain and the chain 
linkage reset. The Data Buffer and the FIB Buffer are then 
both released through tha monitor and their linkages are re- 
moved from the DDB. The common exit Is then taken baek to 
the caller. 


4.4.3 Transfer Bit-map to and from Core 


(GMA) 


4.4.3. 1 GET MAP 


This routine performs two functions* It ean be ea11e H to 
gat a # buffer for a bit mao# read the bit mao into core and 
link this FIB to the end of the FIB chain. The second func- 
tion of the routlne.ls to write the bit map from eore to the 
device. The first function Is called GFTMA»# the second 
WRITMAP. Both are called with the same E*T# with the value 
of R3 determining the aeeelfie function* 

Cal 1 1ng Seguenee* 

a* To read In a bit mao 
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RRapojnter to DD0 
R3«oointer to ODB 
EMT 5R 


b. To write out a bit maci 

R0»oointar to DDB 
R3»0 

EMT .50 
Return Arguments! 

FIB+0 eonteina X 

X«0 if map setup sueassfully 

X»+l if ng buffer available 

X*-l If file already open on DECtepe, 

Description! 

This routine executes entirely within the Swao Buffer (MSB) 
unless It Is made core resident. On entry registers R0 
throuoh R5. the PC end PS ere respectively saved on the too 
of the stack. Upon entry. R0 Is restored from its saved vs* 
lue on the stack, to ?oin$ to the DDB. R? is set to eolnt 
to the FIB linked to this DDBf then R1 is set to the value 
of the core bit map pointer In the FIB, The word count In 
the ODP is saved* and a <*64 decimal, the bit map word count 
Is out Into the 00B. Then the saved value, of R3 on the 
staek Is tested to determine whether this Is a SETMAP or 
WRITMAP cal 1 , 

If writmap is called for. the DDB transfer block number end 
buffer address are saved. Then the buffer address Is set 
eoual to the eore bit map address* the transfer block number 
Is sat up and the bit mao Is written out, The original 
buffer address* the bloek number and the original word eeunt 
are then restored! and an exit Is taken throuoh the eommon 
routine. 3, EXIT. 

If GETMAP is called* a test Is first made to see if there Is 
already a bit mao attached to this FIB. If the FIB bit mao 
pointer Is non-zero there Is a mao attached* so the routine 
restores the original word count and returns to the caller 
throuoh the eommon exit routine with a zero In EIB+0 to In- 
dlcate successful completion. If no bit mao attached the 
routine dears the FIB link of this FIB to indicate end of 
chain and than gets the pointer to the beginning of the FIB 
chain for this unit from the driver. If the oointer to the 
beginning of the FIB chejn Is non-zero there Is already a 
bit map In eore for this unit. A test is then made to de- 
termine if this is DECtaoe. If It Is DECtaoe then you can- 
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not oean a seeond outout flla on the same unit# If not DEC* 
tape and. a file Is open on this unit then link thjs FIB at 
the end of the FIB eheln and Insert core bit mao pointer end 
Interleave factor Into this FIB# and then axlt beck to the 
celling module# after restoring the original word count in 
the DOB. 

When the bit mao is not already In eore It 1e necessary to 
get a 64 word buffer for the mao# This Is done by a eal 1 to 
the monitor GET3UF routine through absolute location 54, 
The GETBUF routine allocates buffers from free eore. The 
buffer Address Is then set in.tha FIB as the core bit meo 
pointer. The MFD pointer in the driver la moved Into the 
DOB and, MFD Si la read in. Then the routine extracts from 
It thf interleave factor and the bit mao block number. Then 
the bit map Is read In and it is linked to the device 
driver. Restore the original DOB and clear FIB+0 to indl* 
eate a successful call. Then leave through eommon exit rou* 
tine, ,THe bit map transfer routine also has an Imbedded 
read/write routine in It, 


4.4.4 Allocation of Blocks to Linked Files (LBA) 


The. function of this routjne Is to allocate one blopk of a 
device. This routine Is eelled under the following three 
conditions* 

1, .ALLOC (Create a Contiguous File) to allocate a 

block for the UFD or to add a block to the l)FD, 

2, .OPENo (Ooenino A File For Outout) to allocate a 

block for the reasons under .ALLOC and also to al* 

loeste the first bloek of the file, 

3, .OPEME (Openino A File For Extension) to allocate 

the first block of the extension. 

The READ/WRITE processor uses a different routine to do 
block allocations while a READ/WRITE is In orogress (see 
Section 4.5.2), 

Cal 1 1 ng Seauence* 


MOV 

PC# P3 


EMT 

53 

IGETWAP 

EMT 

47 

*LIMF RLOCk ALLOCATE 


R0»oo1nter to DDB 

Set R3 egual to non-xero value# then 

make sure there Is a bit mao in core# bv an 
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EMT eall to « GETMAP. 

Return Arguments! 

Sots FIB+B to the bloek number of the allocated bloek, If 

FI8+0 was sot to 0 thon tHo device Is full. 

Description! 

This routine is re-entren$ and execute* entirely within tho 
Swob Buffer (MSB) unless It Is mode eore resident. Uoon en- 
try# tho Roolsters R0 through R5# the PC and tho Processor 
Status ore saved respectively on the toe of tho staek. R0 
Is restored from its saved value on the staek. to oolnt to 
tho DDB. The Bloek Numbor# Buffer Address and word Count In 
tho DOB are thon savod on tho staek. The DOB word eount Is 

then sot to -64 deelmal# for transferring of bit mfps. The 

core bit meo oointor is token from tho FIB and oiut into tho 

DDB as. the Buffer Address for trensfers. end the Bloek 

Numbor of this bit meo is calculated and also out into tho 
DDB. The routine then computes the lowest bloek number des- 
cribed by the eurrent core bit mao, The bit meo Is thon 

seanned on e word by word bools looking for a word that has 

a free bit. If no free blocks ere found in the eyrrent mao# 
it is written out and the. block number of tho first map In 
the ehain is gotten. .The first mao is read In and e seareh 
Is begun of the entire bit meo ehain for a word containing 
an unset $1t. If none ere found the devlee Is full. For a 

full deviee the following oeeursi The Data Buffer la re- 
]ease0 by. the Monitor# Buffer Release Routine. 3.RBUF# end 
its link is eleared from the DDB, Tho Open Indicator In the 

DDB Is eleared, Thf FIB ehain la searched for the preoer 

FIB end when found it Is released bv a call to S.RBUF and it 

Is el so _ uni inked from the FIB chain. The Mpnitor Diagnostic 
Print routine then prints an error eode Indicating e full 
deviee. 

When e word Is found with a free bit a mask 1$ set up to de- 
termine whieh bit. of the word indicates the first free bloek 
available. The first free bit of the word is set when 
found# and the bloek number of the allocated bloek is set In 
DDB+26. This bloek number was belna keot and undated during 
both the word and bi t . searches . The word eount buffer ad- 
dress end bloek number initially saved ere now restored in 
the DOB# and the eommon exit routine S.EXIT Is taken back to 
the eal 1 er. 
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4.5 Normal File Processing 


4.5,1 Opening fJJ_es 


Beetion 3.2.2. 1 showed that all .OPEN calls ape eroeessed 
initially by a general routine regardless of the device in 
gee. However* having executed some common operations such 
as cheeking the, validity of the eall and obtaining the ne* 
eesfary data buffer* this routine then cheeks the 
devieet if it is seen to be f i 1 a*st ruetured* a FIB is at* 
taehed to the DOB* Registers are set to provide relevant da* 
ta and one of two. f i 1 e*management routines is called to eon* 
plete.the processing. The ouroose of this section is to 
describe these routines! 

1. FOP * Open an existing file* eelled therefore for 
.OPENU .OPENE* .OPEN! and .OPeNC - Section 4, 5. 1.1 

2, FCR - Create a new file (e.OPENO) - Section 4, 5, 1,2 

Both routines use the technique described in Section 4,3 for 
moving ,the"selvea out of the Swao Buffer if thev are 
non»reaident . On comoletion* thev return direet.ly to the 
user program and at this time* thev are responsible for 
leaving a mach 1 ne*at ate, exact 1 y as that established by the 
general processor for non-file devices, i.e.t 

1. OPFN switch set in the DOB Status (bit 7* byte 12) 

2, Date-Buffer cleared for expected . WRITE following* 
or 

3, Oata*Buffer filled for exoeeted .READ following 

4. Buffer Pointer aet in POP Driver Word Count* if 2 
or 3 effected! 

a. Linked files! 3TART+2 

b. Contiguous files! START 

In addition* the first file Block must be eorreetlv 
set if ,REA0 or .WRITE may follow* i.e.i 

a. Linked filesf in "Next Bloek" in the. FIB 

b. Contiguous files! in "Device Bloek" in the DOB 
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Q.g»n_sn__Ex iatlnq File 


(FOP) 


The function of the File Open Module (FOP) la to open e file 
structured device for linked file extension (OPENE)* contig- 
uous file. Input (OPENI), or contiguous file outout (OPENC), 
The routine performs the following operations to accomplish 
Its fynetien, It first mekes s directory aeareh to deter- 
mine If the. file exists* since s cell to file Open (FOP) re- 
quires the file to elreedv exist. The routine then cheeks 
If the eeller hss the.seeess privilege he desires. For en 
OPENE It allocates the first block of the extension. For en 
OPENI the first bloek of the file Is reed Into eore. 

Celling Sequence! 

Registers sre exoeeted to be set ss follows when this rou- 
tine Is eelled. 

R0 - Pointer to Oeteset Dete Bloek (DOB) 

R 1 - Pointer to Insert esll ergumente 

The File Open Module is eelled by the Common Open Processor 
(OPN) throuah execution of code In the DDP, Set up end esll 
sequence is ss follows! 



MOV 

S104043*-(SP) 

»EMT 43 PUT ON STACK 


CMP 

(P2),*2 

! SEE IF AN OPENO 


BNE 

EX2 

fBRANCH IF OPENE, 'J* C, OR I 


INC 

(SP) 


EX2 1 

MOV 

( SP) ♦ » • ( R3) 

»EMT PUT INTO DDB 


TSTB 

(P5) 

ITEST IF ROUTINE RESIDENT 


BEQ 

EX3 

IBRANCH IF RESIDENT 


MOV 

(PC)+«-(R3) 

I MUST FREE SWAP BUFFER 


DECB 

(R5) 

! THIS INSTRUCTION PUT IN DDB 

EX3t 

MOV 

R3, PC 

IBEGIN EXECUTING CODE IN DOB 


EMT 43 Cells File Ooen 
EMT 44 Cells File Create 

Return Arouments! 

None 

Dese r 1 pt 1 on i 

When the File Ooen (FOP) Module Is Initially entered It 
tests to. see If It is In the Swap Buffer or. is permanently 
core resident. If In the Swao Buffer it eells the 
Monitor's* Get Buffer routine (GET8UF)* to allocate a buffer 
In free core. It then moves Itself Into the allocated 
buffer. The registers Rfl and PI are them restored from the 
staek. This leaves six words R2-R5* PC end PS on the stack 
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which will be used for EMT .LOOKUP (Directory Seareh) return 
argument , 

The File Open. Module then Issues the EmT .LOOKU?* to see If 
the file exists* If the file does net exist* th« Oeen 
Switch in the DOB status word Is cleared end an EMT .RL9FIB 
(Release FIB) Is Issued to release the FIB Buffer end the 
Data Buffer. The routine frees the Dataset _bv clearing 
DDB+0 and them It must release the free core buffer It oeeu- 
pies* The manner. 1" whieh this Is dome 1e described In the 
last oeraqraDh of this seetlent but the eemmen exit routlme 
goes to the user error return. If no error return was set* 
the Monitor Dlaonostle Print routine is called to print am 
appropriate error eede. 

When the file exists* the. next eheek Is of the Usaae Count 
In the file's UFD entry! if Usepe Count Is 76 or 77. then the 
previous error procedure is followed* the file is open* 
Several mor« tests are new made* If an OPENC* Is It to a 
linked file* this Is illegal if It is. Then for OPENC, OPE» 
NU and OPENS reoueets the UFD entry Is looked at to see if 
the file is locked. If loeked the file can not. be. opened* 
error handled as before. If not loeked* the file js loeked 
then. Then for an OPENF 9 eheek Is made to see If It la to 
a eontlouous file* armor If It is. 

All oeen reaueats that use the File Open Module (FOP)* exe- 
cute this next sequence. An EMT .SETuPFIB Is issued to get 
a FIB and a Data Buffer. The.UIC* the protection eede. and 
the aeeess level neeessarv for the open request are set up 
and an EMT .CKACSP Is Issued to determine If the ealler Is 
permitted the access to. the file that he desires* (Read or 
Write). If access Is denied the error orocedure previously 
described la performed. 

If an OPENC or OPENU the directory entry is written. out. If 
an OPENE an EMT ,GET M AP is Issued to make sure a bit map Is 
in core* then an EMT *BALL0C is Issued to allocate the first 
block of the file extension. The bloek number Is saved In 
FIB+4 • .Then the directory block Is written out. Now for an 
QPENI it is neeessarv to read the first bloek of the file 
into the Data Buffer, The (EOF) end of file swlteh Is set* 
If this 1 * also the last bloek of the file. 

All the„ 0 PEN requests now leave In the same manner. The Da- 
ta Buffer oointer Is set In the DDB i the ooen switeh Is set 
In the status word of the DOB and the Dataset Is set to the 
free state bv clearlnq DDB+0. The routine then tests If It 
Is oermanentlv eore resident! If It Is It leaves directly 
thrpuoh the eommon exit routine* S.EXlT, If In a free core 
buffer the routine must release the buffer It oceuoles be- 
fore returning to the user. This is done by simulating a 
JSR to the monitor's Buffer Release routine bv the Instrue- 
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tion# MOV e#S.RBij8,PC. This force* • Jump to the Buffer Re- 
lease rputlne doe* not out a return address on the stack, so 
prior tp expeutlno the command the address of the common ex- 
it routine Is put on the stack. The Buffer Release routine 
will* when dene# take that return and go dlreetly to tha 
common exit routine, to return to the user. 


Crests a New File 


(FCR) 


The function of the File Create Module (FCR) is to create e 
linked file and .ooen It for outoutj this routine is called 
from the Common Open Processor as the result of an OPENO (0- 
pen Linked File for Cutout) reauest. This routine performs 
the following operations to accomplish its function. It 
tests if the file exists, since for an OPENO reauest It Is 
Illegal for the file to already exist. If not. the routine 
greatps a UFO entry for this file. The. first bloek of the 
file is allocated and t he, aval 1 abl e file information Is out 
into Its UFO entry. This routine also oerforms soma aetuo 
of the FIB. 

Calling Seaueneei 

Registers are exoeeted to be set as follows when this rou- 
tine Is eal led. 

R0 - Pointer to Dataset Data Bloek (DDB) 

R1 • Pointer to User Call Arguments 

The File Create Module is_ca11*d by the Common Ooen Proces- 
sor throyoh execution of eode In the DDB, Set up and call 
sequence Is as follows! 



MOV 

*104443. -(SP) 

»EMT 43 PUT ON STACK 


CMP 

(R2),*2 

t SEE IF AN 0PEN0 


BNE 

EX2 



INC 

( 3P) 

tIF OPENO, E M T 43 BECOMES EMT 44 

EX2l 

MOV 

(SP)t,-(R3) 

f EMT P'JT INTO DDB 


TSTB 

(R5) 

ITFST IF ROUTINE RESIDENT 


BFQ 

EX3 

IBRANCH IF RESIDENT 


MOV 

(PC)+.-(R3) 

IMUST FREE SWAP 8UFFFR 


DECB 

(R5) 

ITHIS INSTRUCTION PUT INTO DDB 

EX3l 

MOV 

R3.PC 

IBEGIN EXECUTING CODE IN DDB 

Emt 

43 • Cal Is File Ooen 


EMT 

44 - Calls File Create 



Ratum aroumentai 
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Non* 

Deeeript lent 

When the Pile Create routine is entered the staek 1s adjust- 
ed to ereate e six word work erea for transferring^ Informa- 
tion between modules, (l,e, Directory Search to Pile Cre- 
ate), Then the rout 1 ne. teste If It Is in the Swap Buffer or 
Is permanently eore resident. If In the Swap Buffer It must 
move Itself out. This, is done by first calling the 
Moni tor 1 s .Get Buffer routine, (GETBUF) to allocate a temoo- 
rerv buffer In free core. The File Create routine then 
moves Itself to the temporary buffer Just allocated, end 
continues execution. 

Now the File Create. Rout Ine Issues an E*T .LOOKUP (Directory 
Search) to determine If the file to be eeened already ex- 
ists, The Directory Search routine (LUK) returns arguments 
In the ataek work area. If this was an Illegal file name. 
If there was no UlC or if the file existed an error has oc- 
curred end, file ereetlpn can not continue. If an error oc- 
curred the open swlteh in the DDB status word Is cleared and 
an EMT, .RLSFIB Is Issued to. release the FIB Buffer and the 
Date Buffer* end then their links ere cleared from the DDB, 
The Open Switch in the status byte of the DDB Is else 
cleared. If #n error return was set up It Is tgken after 
releasing to free eore the temporary buffer occupied by File 
Create, The manner In whleh the free core buffer occupied 
by thp module Is released Is described in the last paragraph 
of this section. But sinee this Is an error axit the return 
is to the users error return address, When there is no er- 
ror return set the Monitor's Diagnostic Print routine Is 
eelled to print the appropriate error cede. 

If none of the above conditions occurred File Create contin- 
ues bv setting up a UFD If there was none when the Directory 
Search was attempted. This Is done bv issulno an E*T .GET- 
MAP to get e bit map buffer if neeessaryi the bit mao may 
already be In eore. An EMT .BALLOC (LI nk Bloek Allocate) Is 
then Issued to allocate a bloek for the 'JFD, The bit meo 
buffer is then written put by Issuing an FMT .WRITEmap, The 
allocated UFD block is linked to the MFD and the MFD Is 
written out. The UFD block Is cleared and then written out. 
The routine then continues as if the file was not found and 
there was a UFD block which contained an emotv directory en- 
try slot. The routine now has the UFD block and a oolnter 
to the free slot. 

If the file did not exist In the UFD the routine looks at 
DDB+2 to see If the Directory Seareh returned a UFD block 
number, containing an empty directory slot. If there wasn't 
an empty slot in the UFD then It Is neeesserv to allocate a 
bloek end link It to the UFD, The seme procedure Is used to 
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do this.es when allocating the first UFO block* If an emoty 
slot existed op when a UFO block is allocate** end linked* 
the following sequence oeeura. The directory block contain* 
Ing the empty slot is reed into core. The index to the free 
slot was eyt In DDBf22* bv the Directory Search routine, 
previously* An EMT ,GETM4P (Get a Bit Map) Is Issued to 
make sure there Is a bit mae In core, A test Is then made 
to see If this Is a seeond open on DECteee* which is not 
permitted* An EMT ,BA|_L0C (Linked Block Allocator) Is Is* 
sued to get the first block of the file* The directory en* 
try is now set up with File Name* Extension* Date* File 
Type* Ufaoe Count of 77 Indicating open for Outaiut* end file 
protection* File length and Last Bloek Number ere cleared* 
An EmT .SETUPFIB is then is$ued to set up file information 
In the FIS* The UFD bloek is then written out* end the oeen 
switch is set In the ODB Status Bvte* If oeemanentlv core 
resident the. routine returns to the user directly through 
the common exit routine. When this routine js executing 
from a temporary buffer In free eore, whleh will generally 
be the ease* the return Is slightly more eomPlex* because 
the buffer It is executing In must be released. The return 
to the user Is performed as follows! The address of the com* 
mon exjt routine Is out on the.steek* then the address of 
the Monitor's Buffer Release routine is moved Into the PC* 
This simulates a JSR to the Buffer Release routine but when 
It goes to the staek for jta return address It will find the 
address of the common exit* end will return dlreetly to the 
common exit routine whleh then returns to the user* 


4t_5 .2 Pr ocessing a .Fil e 

Ones 9 file. has been opened for normal Incut or outout as 
described In section 4.5.1* the user Is able to erdeess Its 
data in Just the same way as fon env other non*f11e devices* 
bv means of .READ or .WRITE, While the Monlton can operate 
upon the date within its own buffer* it also _need take no 
aoeel al . aetlon, However* when a device. transfer is neeessa* 
ry to fill or empty the buffer* the Monitor must now deter* 
mine wHeh actual devlee bloek Is to.be used according to 
the tvpe of file opened* The purpose of this section Is to 
examine the procedure bv which this Is done. 

As noted in section 3*2*2. 2* the principal routine eoneerned 
Is embedded within the .READ/, WRITE oroeessom and this Is 
discussed first In section 4,5,2, 1, 


It Is shown that during the Creation and Extension of a 
linked file* this routine can make use of the bit-mao sag* 
ment brought into memory during the ,OPFN oroeess, until 
this Indicates that no funther bloeks remain unesslgned. In 



this ease* the eore segment mutt be changed end section 
4*5. 2.2 describes the .subsidiary routine colled* usually 
from the system-device* to effeet the switch. 


4*5.2. 1 Next Block Determl net 1 on (OWN eont) 


This section In feet eovars two sequences In the 
.READ/, WRITE processor which ere executed when examination 
of the Facilities Indicator In the driver Interface Table 
shows that the devlee servicing a dataset. Is f 11 e-et ruetured 
(see Section 3*3,1), The first seouenee Is responsible for 
ensuring that the DOB Devlee Bloch Is set uo eorreetlv for 
an ensuing transfer* It must also find out In advenes the 
next block to be used In the output of a linked file In ord- 
er to chain It to the one now being written. The second se- 
quence forme Part of the rel nl 1 1 el 1 set Ion following the 
transfer* In Denticular checking for the end of a file end 
at the seme time beginning the set-UD for the next transfer. 


Celling eng Exit Segueneee! 

As an Integral Dart at the .READ/. WRITE processor* there Is 
no sneelfle call or exit and the Register state follows on 
naturally within the generel operation. However the 
pre-transfer sequence assumes that for a linked file the 
device block « needed Is held In "Next Block *" In the FIB 
whereas It la expected to be already correctly stored In the 
DDB when the file Is contiguous. The sporoorlste 
file-management routine for ,0 P EN sets uo the neeessarv 
state In readiness for the first transfer (see section 
4*5.1)i the clean-ue sequence maintains It (sea below), A 
prooerlv established FIB is also essential* though automatic 
since .READ or .WRITE must be preceded by .OPEN or the re- 
quest Is ^elected (see section 3,2, 2, 2) 

Processing! 

It follows from the previous paragraph that no further ac- 
tion la required before a transfer If "Tvee" In the FIB 
ahows the file to be contiguous. Otherwise* the content of 
"Next Flock *" Is moved jnto the DDB* However for DECtaoe* 
this eould be negative* signifying that the bleek Is to be 
transferred with the tape moving backwards (see section 
4*3.2). Hence the necessary check Is made and the Block M 
and Tape Direction swlteh In the DDB Status are adjusted ac- 
cordingly. once done* preparation for Incut Is also com- 
plete. 

For outout# on the other hand* a search of the eere bit mao 
segment attached to the FIB bv .OPEN must be made In ordar 
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to ascertain the next bloek to be written end link It to the 
current block, Thue the wad segment orlqln and range are 
computed from dote In the, eeoment pre-amble (tee section 
4,1,3),, The start block for the search Is determined on the 
basis of the current block number Incremented by the IP 
field In the PIP (decremented If the Current block is e DEC- 
tape reverse write). The result Is converted to a value re* 
lative to the eeoment origin end If It Is seen to be either 
above or below the eeoment range, it is reset to 0 .to eor* 
respond to the origin. At the seme time, e switch is set to 
restrict the seareh, since only two passes over the segment 
ere needed# one. from the ootimel bloek to the end end the 
ether from the ooooelte end up to the optimal block. 

The value of the optimal bloek 1e used to formulate the ad* 
dress of Its reoresentet i ve bit In the map as shown In see* 
tion 4,1,3, If this bit is 0, it Is reset to 1 to claim the 
blo$k, (1), The block number, absolutely reconstituted bv 
addition of the orlqln, Is stored as the file-link In the 
first word, of the data buffer (neoated for a reversed cur- 
rent bloek on OECtape) and outout preparation is done. 
Otherwise the mao is examined for the flret available bloek 
from the opt 1 mum, ,w1 1 h the current DECtape bloek direction 
determining that for the search, on the following basis! 

1, The adjacent bits in ascending (or descending) ord- 
er within the aame bvte are checked while the bloek 
value is Incremented or decremented, 

2, Successive bvtes In the appropriate direction are 
tested, with the bloek number adjusted by 0, until 
one not containing 377 Is found, 

3, The individual bits of this byte areaoain checked 
as In step l with eor resoondl no modification of the 
block number. 

The searc K is terminated as soon as a 0 bit Is seen and the 
reault is passed on as shown In the last paragraoh. If 
however, the relevant.end of the segment is reached without 
eueeess* the pass switeh Is reversed end the seeond ease of 
the seareh is set up as follows! 

1, On disks, the seareh bloek value Is reset to the 
segment origin. 


1, Because of the Potential re-entranev of tbe ,PEAD/, write 
processor, the actual blt-eheeklng seouenee (approx 30 
msecs) Is carried out at level 7 orlorlty to orevent corrup- 
tion through Interrupt, 
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2. For OECtape# the direction control Is twitched to 
rtvtrte til tht aeareh operations and the currant 
block becomes the aeareh block (for masons given 
In aactlon 4.2.3.) 

Tha aeareh la completely restarted with tha tmnalatlon of 
tha naw Potential block into bit-oeaition, Should tha see- 
ond paaa also fall to produce a vacant block, tha current 
map aaoment must be replaced In memory bv another. Thla Is 
affected by a eall to the aoaclal routine described In the 
nf*t sect 1 gn. On return* the aaareh la completely reini- 
tialised - In this eaaa always helng resumed at the origin 
and the, process la repeated until either a block la found or 
tha device ia seen to be full. (This ease la handled bv the 
aoeelal routine.) 

Once the appropriate action haa bean satisfactorily aeeom- 
pllshedf the set-up seauenee rejoins the mein routine for 
all devices# to earry out the transfer. On return# the ele- 
en-up seauenee Is entered after the necessary pointers have 
been reset. This simply Increments "Device Bloek 0 " In the 
DDB if the file is contiguous. However# the new value la 
checked aoainft "End Block" In the FIB and If, greater# the 
EOD marker la set In th 9 OOP. For linked files# the first 
word of the date-buffer# l.e. the link-word fust read In or 
the onf written out after the search# ia moved Into "Neat 
Bloek" In the FIB# as required for the subsequent transfer. 
The EOD marker Is again set if such link-word is 0 signify- 
ing the end. of an Input file or one forced uoon an output 
file when no more bloeka are available. Normal .READ/, WRITE 
processing then fellows aa described in seetlon 3, 2. 2. 2. 


Comment I 

The pro.eess. for allocating the neat out»ut bloek described 
above, of course performs In much the same way as the module 
LBA discussed In section 4,4,4, The two routines differ on- 
ly# in feet# over their handling of DECtaeei i_Ba Is not con- 
cerned with the problem of blocks written In reverse since 
directory extensions or the first flle-bloeks are always 
forwards. The aooroorlate code could be added end the em- 
bedded aeouenee would then be unnecessary. However this Is 
not done oresentlv for two reasons* 

a. Although the .READ/ .WRITE processor must be re- 
sident for the time being, this need net always 
be the case. The Swap Buffer might not then be 
avellaMe for LB A 1 s use, 

b. Even. If the Swao Buffer la free# the operation 
to fetch LBA must potentially occur for each 
flle-bloek written# l.e. two devlee transfers 



D0S4.RN0 


PAGE *-42 


for one (although the ehaneee ere that onee 1 o- 
aded, IB * In many instance* eouH he used sev- 
eral, times over). Moreover there is always the 
possibility that L.RA might be needed et an in- 
terrupt level while the orogram is being ser- 
viced oerhaDs by a Utilities routine. This 
would be unable to eomDlete end release the msb 
end L8A could not be brought In until It did, 
thus hanolng the svstem. 


4.5.2 .2 Chang t nq Th e Core Mgp Segment ( 6NM ) 

The module ealled bv the bloek allocation routine of the 
.READ/, WRITE oroeesaor described in the lest section Is res- 
ponsible for saving the latest state of the in-eore segment 
in the master bit map stored on the device and for reolaeing 
It by. another segment in accordance with the avowed monitor 
policv for. keeping linked files as far as possible at the 
front end. of the medium. .(See section 4.1,3.) It must also 
provide for th* orobabllltv that no further blocks remain 
free for assignment. However, the module doe*, not itself 
attemdt to examine the segment it may load* this is left to 
the calling rout i ne. 


Calling Seguencet 

The module depends ueon the Redleter state of the 
.READ/. WRITE processor at the call, as saved on the staek by 
the EMT handler* 

R0 ■ Address of the DDR at "Buffer Address" (DDBtB) 

R1 ■ 18 (set ready for aeeess to the driver transfer 
routine - see Section 3.1.2. 4* also used as bloek 
value increment during mao-search) 

R2 ■ Address of the FIB at the first temporary work- 
space (FIB+32) 

R4 ■ Device switch (non-0 for bECtepo) 

In addition, it expects "Next Block #" in the FIB to be 
non-0 when first called (1) and 0 if recalled during the 
same search operation (l.e, because the new segment is also 
full). Also two unwanted items are on too of the staek. 


1. This fellows from the faet that it* normal content can- 
not be 0, since this as a block Is never available for pro- 
gram aeeess (see figures 4-8 & 4-11), 
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The problei ip of eonfllet over MSB usage dlaeussed under "Com* 
manta" . 4* the last aeetlon alao applies to this routine • 
henee module GMA (aaa aactlon 4.4.3) 4a not u*ed. However 
this BPoMeir cannot ba aplved 4n tha aame way # whan tha op* 
eratlon of ehanolng maps 4a paau4Pad mueh too seldemlvi tha 
4ne1ua4on of tha pout4na In Run fa thus unrealistic. 
Nevertheless this Infreoueney makes 4t feasible to risk tha 
same egnfllet fop tha pubsidlary KSb# a4ne« this ean only 
oceup If tha opapatop hapoana to use tha keyboard at tha 
aame time .op aoma papal la] device transfer produces a 
hapdwapa failure. Manea GNM 4a called by EMT 34. I.e.# us* 
4ng a coda forcing SAM to load 4t into KSB (aaa aactlon 
2.3.3). 

As noted in the 4 nt Poduet 4 on# this routine must handle "Dev- 
ice Full" anp 4t will ba shown below that 4t merely aata tha 
E00 mapkep In the DOB and exits dipeetlv to execute the dev- 
ice transfer. To enable 1t„thys to omit a further aaapch# 
It expeets the Inatnuetion before the call to be a bpeneh to 
tha aoppoopiata oolnt. Hanea tha full eel 1 seduenee 1st 

8R RW.TFX tCALL TFR IF DEVICE FULL 
EMT 34 iCALL GNM 

fRFTURN IF NEW SEGMENT LOADED 

Whan entepad# GNM uses tha actual Register state sat by the 
EMT handlep (sea section 2.2.1) es follows! 

R1 ■ Stack addpess of tha first wopd after the eall re- 
tupn parameters 

R5 ■ Address of the processor Status Registep 


Exit State! 

On completion# GNM peealls tha . READ/ ■ WRITE _ processor with 
the original entry state. restored# exeapt for the following 
adjustments to enable pa-initial Izetlon of the aeaPch aa 
noted In tha last section! 

a. R0 ■ AddPess of the DDB at "W©rd Count" CDDB+l 1 *) 

R2 ■ Addpess of the FIB at "Next Bloek" (FIBaa) 

b, "Next 81ock" Itself is cleared to remember the en- 
try (see previous Paragraph) 

e. The unwanted Items on the stack are removed and are 
replaced by a single entry of 1F000 (used as e ro- 
tation counter In the computation of tha segment 
origin). 
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Rroeessi not 

To reduee.the Probability of keyboard interrupt ion, GNM 
first raise* the priority level to 4 (cleared by RTI on ex- 
it) end then extracts end adjusts the saved Register data as 
noted fbove, At the sane time the link-word in the data 
buffer is cleared so that if "Device Full" is seen, the last 
outout transfer correetly terminates the file-chain. 

If GNM is ealled and the deviee is DECteoe, the leading of a 
nfw seoment is imoossible when there is only one (see sec- 
tion 4,3,2) , However the eall is made, because the two-Dass 
search described in section 4,5,2. 1 eeuld, in fact, miss 
cheekino th? bloeka akioped by the aoolieatign of the IF 
(unneeessar i 1 y perhaps - but it obviates special handling in 
RWN for a "once in a blue noon" exereisel). wenee for a 
first entry, GNM Just exits immediately with "Next Bloek" in 
the FIB . cleared, thus forcing a seeond cemolete search of 
the mao segment already in eere and eausino a re-entry to 
result as "Device Full" (see below). 

For disk operations, rather than save the existing content 
of the program's 008, GNM uses its own internal veraion, al- 
ready. aet to transfer always 64 words (see section 4,1,3), 
This is prepared to show the same Driver Address, Deviee Un- 
it §nd Busy Flag content ( in case of error as under), 
"Buffer Address" is entered from "Bit Map St?rt" in the FIB 
and "Oeyiee Bloek" is eomouted from the deta in the map seg- 
ment preamble, "Completion Return" is set to eause the 
driver to call a similar sequence to that. used by 8AM for 
dequeuing the driver, checking for transfer failure, clear- 
ing the buav flag and taking the System Exit (see section 
2.3.4), 

If this is the first eell to GNM for this particular search, 
the current map segment must be written out before a new one 
is loaded. Henee if "Next Block" in the FIB is non-0, the 
driver is called for outout via 3, CDS, with Registers and 
Busy Flag contents saved (see section 2,4,2), .WAIT follows 
- with a link-bloek simulated on the stack. On satisfactory 
completion, the DDB Busy Flag la reset and the block number 
for map aegment *1, as. stored in the map preamble, is en- 
tered - thus alwavs resuming the search from the front of 
the eofplete mao as reouired. When this has been brought 
in, "Next Bloek" in the FIB is eleered to show the GNM entry 
and RWN is recalled. For subseouent coils to Gnm within the 
same seareh operation, the write-out is unnecessary as it 
can be assumed that the segment loaded wes already full. 
Therefore it is omitted and reading of sueeeasive mao seg- 
ments only occurs. 

The form of the exit differs from that previously described. 
Because of the use of the KSB, GNM, like the other rou- 
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eheeks It* resiHencv from th* first byte (Usage 
Count)* however It cannot call th* normal System, Exit# when 
this will decrement the MSB eount as described in section 
2*3,4. Instead t heref orp, , when GNM Ip In the *8* it uses a 
similar form of exit specifically provided for the keyboard 
lanouaga modules# (sea Section 6. 2. 5, 3.). It reauirea that 
GNM stone "RTI" In the third word below the _K9B and also 
that It restore Itself $he saved Registers for the ealllnq 
prooram, The same situation arises# If a device transfer 
falls* In^thls ease# GNM frees the KSB while executing "IDT" 
In lieu of "RTX" (fatal error F&14) (see chapter 7). 


Comments I 

Baeausa of the Internal DOB# GNH currently eannot be 
re-entrant, As shown for «INIT In section 3.2.1.1*# this Is 
no problem as long as 3*H can provide the protection afford* 
ad bw tha r***ntrancv switch In the seeond bvte of GNM (see 
faction 2.3.1), In th* unlikely event that a user requires 
its residency# there could be oroblem* (even though this Is 
Implied bv the eheck mentioned In the last oaraoraph)* 


4*9.3 Closing Files 


(FCL1 


As shown in Section 3. 2*2. 3* all .CLOSE calls# like those 
for .OPEN, are Initially processed by a general routine. 
This ensures that the last block of any file ©Pen for cutout 
Is dlspatehed to the davlee. It then cells a 

f i 1 ••msnaoement routine to Perform directory operations If 
th* davlee In use Is seen to be f i 1 e-st ruet ured, The pur- 
pose of this section Is to examine the routine so ealled. 
Its prim* functions are 1 

1, Update th* master bit m*p on the medium for a file 
under ereatlon or extension# using the latest state 
of the segment In eore 

2, Update a file Pit Mae fo<“ a new or extended file on 
DECtape 

3, Complete the UFD entry for the file to show Its la- 
test state 

4, Release the FIB and Data Buffens to free core* also 
the Bit Map Buffer if no other files are still us- 
i no It. 
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Calling Seauence* 

A call to FCL requires realaters set ae follows* 

RP ■ Pointer to DOB 
R2 ■ Pointer to FIB 
R3 ■ Driver Address 
R4 ■ Modified How Ooan Code (Coda 

The eel ling seauanee from the Common Open Porceasor Is as 
f ol 1 owe i 

MOV *134045***1 
TST8 **5 
BEG .+6 
MOV (PC)t#-(Rl) 

DECB *R5 
MOV Rl * PC 

An EMT 45 is out into the.DOB, A teat ia made to ace If the 
Common Close Processor is In the Swap Buffer* If it Is tha 
Monitor, Swsd Buffer must be free orior to calling the File 
Close routine. This is dona by cutting • second instruction 
whleh frees the buffer into the DDB and then putting Into 
the PC the DDB address where the next instruction to be exa- 
euted Is stored. 

Return Arguments* 

None 

Description* 

When this routine Is entered it first calls the Monitor Re- 
gister Restore routine which takes the saved contents of the 
general registers from the stack and restore* them. The 
modified How Open Code for the File to be closed is than de- 
coded and aoproorlate branches are taken. 

A linked file oeened for output (DPENO), proceeds to close 
as follows* the bloek number of the Vast bloek written Is 
put Into the FIR at FIB ♦ 16* LAST BLOC* WORD. A pointer to 
the driver location whleh contains the desired bit mao ad- 
dress Is calculated and saved. Then a test Is made to de- 
termine If the device is DFCtaoe* If It is DECtsoe# it Is 
necessary to update both the permanent bit mao and file bit 
map. For DECtaoe the permanent bit map Is read Into core. 
The core bit mao# whleh describes the old permanent bit mao 
plus the bloek belna used bv the new file* is written out. 
Then the eore bit map Is bit cleared with the permanent bit 
map# so that the remaining set bits describe the file bit 
map. The file bit mao is read in# end bit set with the mod- 
ified eore bit mao and then It is written out. For Disk it 
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naeesaarv to search the bit mao chain to get the correct 
permanent bit kisd bloek. The core bit mao is then written 
out. If there ere no FIBa left on the FIB ehain then the 
Core Bit M ao Buffer la released# by the Monitor Buffer Re** 
lease Routine. Now the file’s Blreetorv Entry la read In 
and theFfle Information ia uedated with a length and a last 
bloek of file. The bloek containing the directory entry Is 
then written out. The FIB and Bata Buffers are then re- 
leased end the common exit routine is taken. for returning 
to the user. 

A contiguous file ooened for update or output, (OPENU or 
OPENC) proceeds to close in a eommon manner as follows. 

First the block containing the files UFO entry is read Into 
core. The file Lock bit is cleared end the usage eount Is 
decremented. The new filg length and the file’s lest block 
number are out into the directory entry. The bloek contain* 
Ing the file’s directory entry is then written out# the ne- 
cessary buffers are released and the routine returns to the 
user through the eonmen exit routine, 

A linked or contiguous file opened for Input (OPENI) Is 
elosed In the following relatively simple manner. The PIR 
Is released bv the Monitor buffer release routine. Then the 
Data Buffer Is released bv the same routine. Control Is 
then returned to the user throuah a return via the common 
exit routine, 

A linked File ooened for extension COPENE) is elosed In the 
following menner. The last bloek number of the original 
file#, which Is stored In the FIB# Is tested to see if It Is 
negative. A negative block number means the last bloek was 
written backwards# which can only happen on DECtaoe. If It 
Is negative the reverse bit is set In the DDB and the block 
number is negated. Then the original last block is read In# 
and the bloek number of the beginning of the extension Is 
put Into the link word of the block. Then the bloek is 
written out# and the reverse bit In the DBB Is cleared. The 
closing procedure now proceeds the same as closing an OPENO 
file# exeeot when the directory entry is uodated the loek 
bit must be cleared for an OPENE, 
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4.6 Housekeeping QptraHona 

A program need* facilities other than the ware opening# pro- 
cessing# and closing of i|1at< Quite commonly, these files 
may he only temporary - as a way of utilising the 
bulk-storage medium as an extension of available eo^e. At 
later stages# these files must he deleted or he made perman- 
ent under a new name or different orotectlon. Continuous 
files# also* Can only be eroeessed If they are already In 
existence* the means of creating them Initially must be ac- 
cessible, Futhermore# It has. been shown that oeenlng a file 
Is onlv permissible in specified eases*. e.q, OPEMU Is legal 
only for contiguous files# as ,0PEN0 Imnlles that the file 
dpes not exist already. The orogrem may therefore wish to 
examine the device directory in advance to oroteet Itself 
against error. Hence the appropriate Program requests ere 
provided for these operations end the object of this section 
Is to describe the manner In which they «*e Processed, In 
general* these requests are valid only when a file Is not 
already, opened on the dataset concerned and although the 
proeeasjna module Is alwevs called# It ignores the eell If 
the deylee is not f i 1 e-st ructured. 


4,6,1 Allocating Contiguous Files 


i.U-0 ejLt e Ja t ru g 


CJJJD 


The function of the module is to create. a contlauous file by 
searching e device's permanent hit mao from the end# looking 
for the aoproer late number of unoecuoled contiguous blocks. 
When found the cor resoondl no hits ere set In the permanent 
bit map# and an entry Is made In the UFO for the file. 

Calling Seauence I 

HOV *NU M *-(96) 

HCV <FILBLK..(R6) 

MOV aLNKBLK,«(R6) 

PUT 15 

NiJM • Number of 64 word units desired 
Return Arguments* 

A value of -l returned on top of the stack Indi- 
cates a successful allocation. 
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A, value of X, not eoual to "1? is returned on th* 
top of the stock when allocation was unsuccassf ul , 
The value returned, X, Indicates the site of the 
largest alloeatable segment available# In B4-word 
units. 

Deaeri pt 1 on* 

The module first eheeka to see If It is In the Swap buffer. 
If It .Is It requests a buffer from free eone through tha 
Monitor's Get Buffer routine (GET*UF) end then moves Itself 
Into It. If a free eore buffer is. not available end an er- 
ror return was not set up, the Monitor's 51 agnost i c Print 
routine Is celled to erint an eoproorlete emror code. If an 
error return was set up It is taken bv the common exit rou- 
tine after releasing the neeessarv buffers. 

The rout 1 ne. tests to see if this is a file structured dev- 
ice, and_ if not# the routine exits through the common exit 
routine after freeing the Dataset and cleaning up. the staek. 
The routine also releases the free core buffer It occupies 
throuoh the Monitor's Buffer Release routine S.RBUF which 
returns directly to the common exit routine 8. EXIT, The 
•ueeesa Indicator (-1) is returned on the stack. 

The_EMT .3ETUPFIB Is issued. at this Point to get a Data 
Buffer and a FIB. If no buffer Is available, use the previ- 
ous error exit for no buffer, Mow en EMT .LOOKUP Is Issued, 
TfSts ere made for on illegal file name# no UlC# and If the 
file alreadv exists. If anv of these errors are detected, 
the error . return In the file block Is taken, if there Is 
one* otherwise, the Monitor requests Error Diagnostic Print, 

If there is, no UFD It gets the first UFO block by getting a 
bjt map Into eore# allocating a linked bloek and writing the 
bit mee oyt. The U p 0 Is then linked to the MFD. Then the 
MFD Is written out. 

If there was a UFO see If the Emt .LOOKUP found an emotv 
slot for the file entrv. If no emotv slot add a block to 
the UFO, ,A new UFO block or the first UFD block Is gotten 
In the following manner. An EMT ,GET M AP Is Issued to make 
sure a bit mao Is In eore. An EMT .BALl.OC Is Issued to al- 
locate a block for the UFD and then an EMT ,W®ITMAP Is Is- 
sued to write out the bit map. The bloek to whieh this one 
will be linked Is read In, end the linking takes elaee. If 
the device was a OECtape and there were no empty slots an 
error Is detected end handled In the orevioys manner. The 
new bloek Is linked to the lest and the last is written out. 

Now move the file name and extension which we#e put on the 
stack bv the EMT .LOOKUP# Into the UFO entrv. Clear the us- 
age count# the file start# length# and end. Also out pro- 
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teetion eode from the stack Into the uFD entry. Than write 
out the u?D bloek. 

The routine now sets up to call the Contlauous Block Alloea- 
tor (CBA), The addressee of the Reed routine end the Write 
routine In the A|.0 module are passed to the Contlauous Block 
Allocator through registers R4 and R5. The E M T .GETCONTIG 
(Emt 51), Is issued. This allocate! the requested number of 
contiguous blocks If available. If the requested number of 
blocks wane allocated the success Indicator (-1) is moved 
Into the return araument position. If the reauested number 
of blocks Is not available the largest number of available 
eontlouous blocks Is moved Into the return araument. An EMT 
,RISFTB Is issued to release the FIB and the Buffer, Then 
the routine returns to the caller through the common exit 
routine. Before netumlna to the ealler it Is neeessarv to 
release the free eore buffer occupied by the Allocate Rou- 
tin? (ALO) , This is done by simulating e J3R to the 
Monitor's, Buffer Release routine, S.RBUF but setting the 
stack sin S.RBUF returns directly to th* common exit routine 
which frees the Swap Buffer end returns to the user. 


4, 6, 1.2 Contiguous Bloek Allocator 


(C8A ) 


This module. Is called only by Allocate (ALO) end its func- 
tion is to allocate the reauested number of contiguous 64 
yord unjts. The function Is performed by searching the dev- 
ices .bit maos from the highest number bit *eo's last word 
end working towards the beginning of the device's bit maos. 


Celling Sequences 

R3« ADDRESS OF DOB 

R4«ADORF3S OF WRITE ROUTINE IN ALO 
R5« ADDRESS OF READ ROUTINF IN ALO 

FIB+0»ORIGINAL Rl, POINTER TO CALL ARGUMENTS 
FIB+2-DIRECT0RY BLOCK 
FIB+4-DIRECT0RY INDEX 

EMT 51 


Return Arguments* 

RlaNumber requested 
R2»Largest number available 
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Daaeript loni 

When this routine.!* Initially ^nt*p«d the Monitor’* Regis- 
ter Restore routine is called to reset the registers, Then 
the addresses transferred throuoh registers R4 and R5 are 
set uo f o •* use of the READ/kRITE routines belonging to the 
calling module (ALO). Pointers are set to the driver and to 
the FIB | and the drivers standard buffer sl*e Is eleked uo 
for t^a next computation, Then the number of 64 word units 
desired Is converted Into blocks, R4 will be the number of 
blocks. 

Read In the MFD block. Then determine If there la a bit mao 
In core for this device and unit number. If there Is a mao 
In eore# look down the list of maos to find the current one, 
save .Its eore address and bloek number then write It out. 
This is done so It can be restored before returning to Alio* 
cate C A l 0 3 ■ he now oroeeed as If there was no mao In eore. 
Read in the. last, highest numbered mao. Then set up as fol- 
lows, for bit mao seareh. 


4 ( R6 ) ■ Cleared.# highest count to date 
2CR6) ■ Number of blocks needed 
(R6) » (Address -2) of lest mao word, 

R1 ■ Address of first word of mao 
R2 ■ Address of last word of mao 
R3 ■ High block number in mao 
R4 » Cleared# for counter 
R5 ■ Mask 

This seetion of the continuous bloek allocation module (C9A) 
searches the bit maos to find the number of contiguous free 
bloeks requested. Shift a mask through each word of the mao 
looklnq for the required number of successive "off bits. 
If an "on" bit is reached before the required count Is sa- 
tisfied# uodate 4(R6) with the highest count to date. Then 
continue mask search. If the bottom of a mao is reached 
read In the next mao and continue. If no more maos to be 
read# get the directory entry bloek# clear this entry and 
write the directory entry block out. Restore original mao 
In core If there was one and then exit beck to the Allocate 
Routine# through the common exit routine# S.EXIT, Upon exit 
Rfl will be restored# R1 will contain the number of units 
needed and R2 will contain the highest number found. 

If the required number of bits have been found begin setting 
them successively In the bit map. If the end of the mao Is 
reached before setting all the necessary bits* write this 
map out and read In the next. Then continue setting the ne- 
cessary bits# uoon completion write out this block. If 
there was originally a bit mao In core# then read It back 
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In. Reed the directory entry* set Test block, lenoth* and 
•tart, bloekf then write tha directory entry out end exit as 
described above. If R1*R2 allocation was successful. 


4.6.2 Bel at i ng Fi l es 


4^6,2. 1 Oelet i on Set * up 


CDEL) 


The function of the module is to delete. a file on a file 
atructured device. Delete determines if the ealler has the 
necessary access privilege to delete the file. Delete is 
divided, functionally into deletion of three tyoes of file 
deletes. 

1, DECtape delete, - 

Bit clearing of the file bit map uoon the permanent 
bit mao, 

2, Disk linked file delete - 

Cells the delete linked file module (D(.N) to follow 
the file's chain of links to determine which bits 
in the permanent bit map to clear. 

3, Disk contiguous file delete • 

Calls the delete contiguous file module (DCN) to 
taro the link words from start throuah tha lenqth 
of the file. Than reeds the bit mao* and clears 
length consecutive bits beoinnino at start. 

START ■ FIRST BLOCK OF THE FILE 
LENGTH ■ NUMBER OF BLOCK IN THE FILE 

Calling Seaueneei 

MOV FFILBLK.-fRB) 

MOV *LNKBLK,-(R6) 

EMT 21 

Return Araumentei 
None 

Dese r i et i on * 

The delete module first determines if it is in the S«ao 
Buffer,, If it is it gets a buffer from free eore through 
the Monitor's Get Buffer routine (GETBuF) and moves itself 
into it. If a buffer is not available the module releases 
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the ntetssary buffa^i* free* the Dataset end leaves through 
t h* eomnon $x i t rout i n*. 8 , EX IT which takes the error return 
address. If there la no error return address, a massage Is 
printed, by th* Monitor Diagnostic Print routine identifying 
the error. 

The routine tests to see If the dataset Is busy, and If It 
Is the sane error oroeedure.es above is used. Then the dev* 
lee is checked for being file structured. If non file 
structured an Immediate exit is taken back to the call 
through the common exit routine. 

Delete now issues an EMT . 8 ETUPFIB, to get a Data Buffer and 
set U 9 a FI?, Then. an EMT .LOOKUP Is Issued to determine If 
the fjle exists. If the file dees not exist it Is an error 
and is handled In the erevious manner. The cellar's access 
privilege is then eheeiced (via FMT .CKAC3P) to determine If 
deletion of the file is permitted. If aceess privilege Is 
denied the Previous error handling procedure is followed. 
The routine then tests, if the file Is ooen and if so the 
previous error procedure is followed. 

If no errors to this point the routine ealls the Monitor's 
Get puffer routine (GFTRUF) to alloeate a 236 word buffer. 
Than Its address is stored In R2, The R? Buffer will be 
used for reading in the device's. MFD block* and bit maos. 
The Delete routine then determines if the device Is disk or 
DECtaee. 

If DE.Ctape, the routine determines the block number and In- 
dex of the directory entry, and then dears the directory 
entry from the UFD and writes the UFD block out. Mote th* 
bloek containing the directory entry Is still In core from 
the EMT, .LOOKUP eal 1 , Mow calculate the block number of the 
filf bit mao. Read the permanent bit mao Into the R2 
buffer. If the file is contiguous an EMT .DELCHNTIG (delete 
contiguous file) is issued whieh updates the oermanent bit 
mapt ypon return the oermanent bit mao is written out. If 
the file Is linked, read In th* FPM and bit clear the oer- 
manent bit mao with the file bit mao, and also dear the 
file bit m*o. Then write the file bit mao and the permanent 
bit mao out. For both linked and contiguous DECtaoe files 
the aame action Is now taken. The 256 word R? buffer Is re- 
leased jnd the routine exits as described in the last para- 
graph of this Section. 

If the devlee Is disk an EMT .DELCOMTIG (delete continuous 
file) or an EMT .OELMK (delete linked file) Is Issued. 
Restore the user file directory buffer address and bloek 
number, dear th* file entry and write the JFn out. 

Now for both disk and DFCtaoe files the following exit Is 
taken. An EMT .RLSFIB Is issued to release the FIR and the 
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Data Buffer. If thfa module fa not permanently eore reaf* 
dent ft la necessary to rel eaae the free core buffer ft oe« 
euoies. Thfa fa done bv aettino the addreaa of the common 
exft routine as the return addreaa for the M©nftor*a Buffer 
Release routines then afmulatina a J8R to the M©nfton*e 
Buffer Release routfne* S.RBUF, The eommon exft routfne ra» 
turna to the user. 


4. 6. 2. 2 Deletion of Contiguous Files 


(J5CN) 


The function of tMa module fa to aaafat fn deletfon of a 
contfououa file from disk or DECtaee. Thfa module performa 
the File Menege«ent ooeratfona whfeh include updating the 
device's permanent bft mapa« and elearfng the File's block 
links fro* atart through length. Thfa module fa ealled only 
from the ffle atrueturea module delete (DEL). 

Calling Seoueneei 

R0 • Pointer to DDB 

R2 • Pointer to 256 word auxiliary buffer 

STACK "Holds return information from directory 
aaarch (EMT .LOOKUP). 

EMT 54 


Returo Aroumentai 
None 

Description* 

When the Delete Contiououa Fflea M 0 du1e (DCN) is initially 
entered a teat ia made to determine if the deviee fa dfak or 
DECtaoe. Dfak Ffle deletea and DECtaoe File delates are 
handled in two aeoarate aectfons of thfa module. First Dfak 
deletea will be dfaeuaaed and then DECtape deletea. 

For a contfououa file delete from dfak the module ffrat 
eleara the bit mao link word and aeta the bit meo buffer ad» 
dreaa in DDB + 6 (BUFADR.) saves the original wocd count and 
aeta the DDB word count ao that only one word* the link 
word*. will be transferred. The Tranafer Block Number f n the 
DDB fa then set to the start bloek of the file. Then the 
routine loops throuoh the file clearing the lfnka bv 
tranaferrfno out one word* the cleared link word until 
lenoth (file length) haa been satisfied. Then* ft reatores 
the orfoinal word count. 
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Now first MFD block read Into eore. If a bit man Is 
In cope# Its address and block number ape saved and It Is 
written out. whan this Is complete# op no bit map was In 
eore# the following oceurs. The bit map numbep eorresoond- 
Ing to the staptlnq bloek of the file Is computed. The bit 
map is now pead In. The, staptlnq block numbep Is eonvepted 
to a oaPticulep bit position in the map. The bits eorres" 
pqndlnq to this file are then cleared, If the end of the 
bit mao Is peached before completion# this mao Is wpitten 
out and the next mao is pead in# and the bit clearing eon* 
tlnues. Upon completion of the bit eleaplng, the euppent 
map is written out. The neeessspy buffers ape peleased and 
the poutlne exits thpouoh the eemmon exit rout 1 ne, ContPol 
Is returned to the Delete Module (DEL), from whleh Delete 
Continuous Files (DCN) wes celled. 

Fop a contlouous file delete fpom DFCtaoe# a mueh slmpleP 
ppoeedupe Is reaulreo. The file's starting bloek end lenqth 
are atoned In two pegisteps. Then the starting block of the 
file la converted to the coppeapondi ng bit, In the DECtaoe 
permanent bit map which Is In cone when this poutlne Is 
ealled. The bits In the pepmanent bit map eor reaoendl nq to 
the file blocks are cleared beginning at start and going 
throuah length bits. The common exit routine (S.EXIT) Is 
then used to return to the Delete Module (DEL)# from which 
Delete Contiguous Files (DCN) was called. 


4,6. 2. 3 Deletion of Linked Files 


(DLN) 


The function of this module Is to assist In deletion of a 
linked file from disk. This module accomplishes its fune* 
tlon through performance of File Management operations! 
which inelyde updating the devices permanent bit moos and 
clear the link word of the file's blocks. This module Is 
called only from the file structures module delete (DEL), 

Cal 1 1 nq Seouence j 

E y T 53 

Return Arguments* 

None 

Dese r i ot 1 on l 

For a linked file delete from disk the Delete Linked Files 
(DLN) module first reads In MFD «i, The present word count 
Is saved and the wed count Is set for 64 word transfers. 
If a bit mao Is In core It Is written out and Its buffer ad- 
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dress and block number are saved* Set uo for one word 
transfers and determine the block number of the first bit 
map# and read It In. The routine reads In the link word of 
the first 6 blocks of the file# then writes out a tero link 
Into the first six blocks* unless the file occupies lass 
than 6 blocks the last link Is ssved. See If the bit mao In 
core eovers the modified file bloeks. If not write It out 
and rpad In the orooer bit nee, Now clear the oor resoondlno 
bits in the. bit mao. The routine continues In this looo 
till ,the file end. The saved link Is now the next bloek of 
the file to be read In, The module continues through the 
file In the above manner saving links# eleerino link word 
and elearina bits In the appropriate bit msa. when a care 
link 19 detected# the end of the file has bean reached. 
Then write out the current bit mso. If a bit m*o was origi- 
nally In eore read It back In# release the neeesaary buffers 
end exit beck to the delete (DEL) module# throuoh the common 
exit routine. 


4,6.3 Apoendlno Files 


4.6.3 . 1 Append General Routine 


(APP) 


The function of this module Is to eeoend two linked files 
together, Appendina Involves linking FHEA to FILER and ad- 
justing the file entry for FILER, If It happens that the 
device Is DECteoe module AP2 Is elso celled to modify the 
DECteoe bit maps. FHEA ceases to exist as a separate file 
and Is now cart of FILER. 

Calling Saaueneei 


MOV 

*FILEA,-CR 6 ) 




MOV 

*FILER#«(R 6 ) 




MOV 

*LNKBLK,-CR 6 ) 




EMT 

22 




filea 

- Address of the 

UFB 

for 

File A 

FTlEB 

- Address of the 

UFR 

for 

File P 


Return Arguments* 

None 

Descript Ion* 

This module first checks to see If It Is In the Swap Buffer 
end if It Is It gets a buffer from free eore through the 
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Monitor'* Get Buffer routine end then move* Itself into it. 
It then teats to see 1 f an assignment has been node or If 
tho dataset 1* busy. If either condition occurs an error Is 
dateetad end handled as follows. The stack is adjusted for 
an exit! if an error return was set uo the neeessary buffers 
are released. and th* error return is taken through the com- 
mon exit routine. If an error return was not set uo an ap- 
propriate error code Is orlnted by the Monitor Diagnostic 
Print routine. 

If the above errors were not detected an E'lT ,3ETUPFIB la 
Issued to set a Data Buffer and a FIB, The routine also 
makes a call to the Monitor's* Rat Puffer routine (GETBUF) 
to allocate In free core an auxiliary buffer of 256 words! 
Its address Is kaot on the stack, * test Is made for a file 
structured device* and If not tile structured the neeessary 
buffers are released and the common exit Is taken baek to 
the eel 1 ar. 

If file structured an E M T .LOOKUP Is Issued tg see if p ILEP 
exists. If the fUa doesn't exist or If It Is open* the 
previous error handling for a busy dataset (B file block) Is 
performed* A test Is now made to sea If the file Is contig- 
uous) If It Is this Is an error and the error procedure Is 
followed. If no errors detected an E M J ,CKAC3P Is issued to 
cheek for protection violation* 1,a, does the caller have 
writ* access. If a protection violation eceurs the previous 
error handling procedure is used, Th* same procedure as 
above Is used for FILEA, if FILEA Is the same as FILEB re- 
lease the neeessary buffers and exit baek to the ealler. If 
not the same* th* file name and extension are cleared from 
the directory entry for FILEA* and this directory bloek is 
written, out* The routine saves In the FIB the following In- 
formation for FILEA! block number* directory address* the 
start* length and end of the file. The directory entry for 
FILEB Is now read In, The new file lenoth is computed and 
sat in the dir*etorv entry along with the new file end. The 
updated directory entry for FTLFB is then written out. 

Now th* devie* Is cheeked as to whether it is disk or DEC- 
tape. If the device is DECtaoe and the block number of the 
start bloek of FILE* is negative* make it positive end set 
th* DECtaoe reverse bit In the status word of DDB. The rea- 
son for th« above Is that the firstblock of a DECtape file 
Is always written in f»e, forward direction. If the link to 
a bloek is negative this indicates It was written In th* re- 
verse direction. Thus the. link to a block written in the 
forward direction must b* positive. 

Now for both disk and DFCtaoe move the start block of FILE* 
Into the FIB, Then read the end block of FILES into core. 
Move thg link to FILEA start bloek into FILEB end block. 
Then write this bloek out. This links FILEA to FILFB. 
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Now if the device is OECtaoe en EMT ,ApNDP2 (Append Pert 2)» 
it issued to set the hits in the PILES bit mao thet were set 
in the PILE* bit mao# and elear the set. bits in the FILEA 
bit mao# then write out the FILEB bit mens* Upon return 
from the Append Part 2 Module or if the device wee disk the 
following Procedure it followed. DDb+ 0 it cleared to free 
the Dataset# an E M T .RL8FIB is issued to release the FIB and 
the Data Buffer, The 255 word auxiliary buffer is released 
throuoh a call to the Monitor's Buffer Release routine. 
Finally the addrese of the common exit routine# 8, EXIT ia 
put on the stack. Then a JSR ia eimulated to the Monitor's 
Buffer Release routine to release the free eore buffer ©ecu* 
pied by the. Append Module. Uoon completion the Buffer Re- 
lease routine returns direetly to the common exit routine 
which returns to the user. 


4 .6. 3. 2 Special Append Operations on DECtaeie ( AP2) 


The function of this module is to modify the file bit maos 
when FILEA is appended to FILEB, This routine is ealled on- 
ly by the module Append (ApP)# and only when the device is 
DECtaoe. 

Calling Seauencet 

EMT 55 

Registers are set as follows when this rou* 
tine is called) also FiR+0 and FI9+2 contain 
the following pertinent information, 

R2»FILE B Bleek Number 
R3«FILE B Directory Addhess 

FI8m0«FlLE A Bloek Number 
FIB+2»FILE A Directory Address 

Return Aroumentsi 

None 

Descript ioni 

This routine first reads in the file bit mao fon FILEA and 
then the file bit mao for FILER, The routine then sets the 
eor respnndi ng bits in FILEB bit map that are set in the FI* 
LEA bit map and clears the set bit in FILEA bit map. Now it 
writes out FILEA and FILER file bit maps. Now exit baek to 
the aopend (APP) module throuoh the eommon exit routine. 
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(Before reading In the f|1* bit mao* a subroutine la tailed 
to ealeulate the bloek containing th* desired file bit mao 
and the Index Into the file bit map,) 

Subroutine Inoutsl 

2(RB) *Di reetory Bloek 
4(R6)«Index Into Directory 

Subroutine Outputs! 

2(R6)«File B1t-n#o Bloek 
4(R6)«Index Into File Bit-nap 


Ailii Renaming Files 


(REN) 


The function of t h 1a nodule Is to ehange the name and pro- 
tection code of an existing file. This Is done by reading 
In the Oldnam UFD entry, eheeMng the caller** neeess, then 
novlna the NEWN*M and protection into the OlDNAM ijfd entry 
and writing out the UFD bloek. This routine is ealled di- 
rectly by th# user. 

Cal 1 1 ng Seauenee! 


MOV 

4NEWNAM, 

MOV 

40L0NAM, 

MOV 

4LNKBLK, 

EMT 

20 


0L0NA M -is the address of the existing file's 
filename block, 

NEdNA^-is the address of the filename block 
eontalnlno the new Information, 

Return Arauments: 

None 

Description! 

The modul e first cheeks, 1 f It Is In th# Swao buffer and If 
It is It nets a buffer from free eore» through the Monitor's 
Get Buffer routine (GFTBUR) and then m 0 ves Itself out of the 
Swao .Buffer Into the free core buffer. The routine then 
cheeks if the dataset. Is busy. If It Is busv. the Rename 
call was Illegal, If an. error return address in the OLDNAM 
file bi«ck was set up, this Is taken by the eom-on exit rou- 
tine after releasing the free core buffer that Rename oeeu- 
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pics* If no error return# control aoes to the Monitor Olaq- 
nostle Print routins whleh identifies the emr. 

For the esse of a non-bysv data set an EMT .SFT'JPFIB Is Is- 
sued to oat a Data Puffer and a FIB* A cheek Is then made 
to sea if the device is fjle structured# If net file strue- 
turad an Immediate exit Is taken after releasing the neces- 
sary buffers. 

If the deviee la file structured an E*t .LOOKUP Is issued to 
determine If the old named file exists. If the file doesn’t 
exist# If. the caller is not the owner of the files or If the 
file Is in use an error is detected and handled as follows* 
If an error return had been set uo in the OLDMA* file block# 
It Is taken by the common exit routine after releasing the 
necessary buffers# through the Monitor’s Puffer Release rou- 
tine whleh returns directly to the common exit routine. For 
the ease of no error return address the Monitor Diagnostic 
Print routine# prints an identifying error eode. 

If the file does exist end the caller is the owner# a second 
EMT .LOOKUP Is Issued to see if the new file name Is in use* 
If the file was In use or a .LOOKUP error occurred the pre- 
vious error handling procedure Is used. If the file name Is 
available end no errors were detected the bloek containing 
the directory entry of the old file Is read In, The new 
file name# extension# and protection code are moved Into the 
file entry and the block is written out. The FIB and Data 
Buffers are released by Issuing an EMT .RLSFIB, It Is now 
neeessary. to release the free core buffer that Rename occu- 
pies. This Is done bv cutting the address of the common ex- 
it routine on the staekj then e JSR to the Monitor’s Buffer 
Release routine Is simulated but no return Is put on the 
staek. when the Buffer Release routine returns it goes HI- 
reetlv to the common exit routine which returns to the cell- 
ar. 


4.6.5 Protecting Files 


(PRO) 


The function of this module Is to protect a file from auto- 
matic deletion upon logout (finish command). This routine 
Is ealled direetlv by the user and orotects his named file 
bv setting bit 7 of the protect bvte In the file IJFD entry. 

Calling Seouence 1 

MOV #FILBLK,-(R6) 

MOV FLNKBLK » - ( RP) 

EMT 24 
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Return Arguments* 

Non® 

Deseript Ion* 

The module first eheeks to see If It 1# In the Swap Buffer 
or Is permanently core resident. If In the Swap Buffer the 
module aets e buffer from free eore# through s eell to the 
Monitor's Get Buffer routine (GPTBUF)# end then moves Itself 
into It. The routine now tests the. status byte In the DDB 
to see If the Osteset Is busy. If the Pataset is busv the 
module eleans uo the stack# clears DDB+0 to free the beta" 
set# and sees if an error return address was set bv the 
gseri then releases the free core buffer It occupies throuah 
the Monitor's Buffer Release routine whleh returns directly 
to the common exit routine which qoes the user's .error re- 
turn,. If no error return was set an error Identifying mes- 
sage is printed# through the Monitor's Diagnostic Print rou- 
tine. 

If the Pataset was not busy the module issues en EMT .SETUP- 
FIB, to. get a Data Buffer and File Information Bloek, The 
devief is then checked for being non-file structured. If 
non-file structured an Immediate exit is taken# after re- 
leasing necessary buffers# similar to error exit above ex- 
cept eommon exit routine goes to the user's eell Instead of 
error return. 

An EMT .LOOKUP Is now. Issued to see If the file exists and 
If not open. If the file. does not exist or Is open the pre- 
vious error procedure Is followed. Whan the file exists and 
la not. open the protect bit ean now be set. Bit 7 of the 
protection byte of the file's UFD entry Is then set# and the 
UFD block Is written out. The UFD block was In core from 
the EMT .LOOKUP call. The FIB and Data Buffer are released 
bv Issuing an EMT .RLSBUF, Then the routine releases the 
buffer it occupies by e Cfll to the Monitor's Buffer Release 
routine which returns directly to the common exit routine# 
which returns to the user. 


4,6.6 Directory Status 


(DIR) 


The function of this module Is to determine If a Particular 
file exists within a particular UFD. The routine also de- 
termines the permitted methods of aecess for a file and op- 
tionally determines the starting block of a file. 
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Cal 1 arounenta 


1. Optional function not deslrad, 

MOV *FILBl*#-(R6) 

MOV #L^KBLK»-(R3) 

EMT 14 

2, Optional function dealrad, 

MOV *FILBLK,«(R6) 

CLR -(R6) 

MOV #LNKBL*<>»<R6) 

EMT 14 

Return Araunentai 

1. Optional function not desired 

(Rfl) • number of bloeka In the file* In binary 
2(R6)-f11e Indicator word 

2, Optional function desired 

fRfl) - start 1 ngbl oek of the file 

2(R6) • number of blocks In the file, in blnarv 

4(R6) • file Indicator word 


FILE INDICATOR WORD 


BIT 0*1 
BIT 1*1 
BIT 2*1 
BIT 3*1 
BIT 4*3 
BIT 4*1 
BIT 5*1 
BIT 6*0 
BIT 6*1 
BIT 7*0 
BIT 7*1 
BITS 9-15 


.OPENC allowed 

,0PFNI allowed 

•OPENE allowed 

• OPFNU allowed 

File not in use 

File in use bv another dataset 

Dataset already has a file open 

File is Link.d 

File is Contiguous 

.OPENO allowedCflle does not exist) 

• OPENC not allowed ffile exists) 

Protection Code 


Notet If a file is protected against READ aeeess 
It will be signaled as non-existent to a caller 
other than the owner. 


Descr 1 ot 1 on i 


The. module first tests to see If It la in the Swap Buffer* 
If it Is it gets a buffer fro* free eore through the Monitor 
Get Buffer routine (GETBUF), and then neves Itself into it. 
A test is then made to see If the Dataset Is busy. If the 
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Dataset Is busy the return Information It pgt on the stack* 
(bit 5«1) the buffer Is released and the routine exits back 
to the user. If the dataset was not busy an E*T .SETUPFIB 
Is issued to oet a Data Buffer and a FIB, Tf no buffers are 
available an error is Indicated either by an error dlaonoa- 
tic being printed or return through the error return address 
In the link block* If present. 

If the devlee la not file structured, the file exists bit Is 
aet In the indicator word. Then If the "output allowed" bit 
Is set in the driver the DPENC permitted bit is set In. the 
Indicatpr word and the file exists bit Is cleared. If the 
Input bit Is set in the driver the OPENE bit is set In the 
indicator word and the file exists bit remains set. The re* 
turn arouments are now out on the staek. Zero is put on as 
the file length* and as the starting block If this Is re- 
quested. Then the file Indicator la out on. The necessary 
buffers are released and the routine exits back to the eall- 
er. 

If the deviee Is file structured an EMt .LOOKUP Is issued to 
determine. If the file exists and Its character 1 at i es . Tf an 
Illegal file nine Is detected the routine takes the error 
exit in the file bloek, or calls Error Diagnostic Print* If 
there Is none. If the file Is not found by the .LOOKUP* the 
return Information is set on the staek* the necessary 
buffers are released and the routine returns to the ealler. 
If the file exists and no. errors have been detected an EMT 
.CKACSp is issued to cheek if read aeeess Is permitted, If 
read aeeess Is not permitted the. seme return Is taken as If 
file not found. The available information la now used to 
set the appropriate bits in the file Indicator word. A sec* 
ond E M T .CKACSP Is Issued to see If write, access is permit- 
ted. . On. the return eporoplate conditions bits are set In 
the file indicator word* baaed on a sequence of tests* If 
the ealler has write aeeess. If the file Is locked It can 
not be written on. If the file Is linked OPENU .and OPEhlC 
are allowed. If the file Is contiguous* OPFNE is. allowed. 
The starting block of the file is out on the stack if It was 
requested* and then the length and file Indicator word are 
put on the stack. The bate Buffer and FIP are released by 
Issuing an EMT .&LSFIB. DOB+SJ Is cleared to free the Data- 
set t if not permanently core resident the free core buffer 
that the Directory Status Routine occupies must be released. 
This Is. done by simulating a JSP to the Monitor's Buffer Re- 
lease. rout 1 ne and then having It return directly to the com- 
mon exit routine which returns to the user. 
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4.7 Magnetic Tape Structure 


Magnetic Taoa Is being treated Individually because of ft* 
•Die1«Hi«a structure. Magnetic Tape Structure Is File orl- 
ented_but has no dlreeterv structure as previously defined. 
Its f 11a structure handles eontlououa record Files In ia a 
ouential ordering. The files are Identified hy the use of 
labels making up the first record of eaeh fils. 

A Magnetic taoa file la a collection of seauentlal records 
bounded by and of file records or by bottom of tape marker 
and an and of File reeord. For "TRAN" non-Flle etruetured 
proeesa.ina the records of a File may be from 2 to 32767 
words Iona, For File structured "OPEN/eLOSE" processing* 
eeeh reeord of a F11a_1s 256 words long except for the First 
reeord, whleh Is the file label and whieh Is 7 words long. 

In order to perform label searching to suoeort multlole 
files on maonetie tape It Is neeessary to know when the lest 
file on a Tape has been passed. This Is accomplished bv 
havlno CLOSE, for an Output File, write a logical and of 
tape (LEOT), which Is a null-FIle. A null-FIle Is 3 and of 
File records with no Intervening data records. Mew Files 
which are added to the taoa write over the old LFOT and 
write a new one after their lest reeord. 

Eaeh FHe,ereated bv OPEN Processing has as Its LABEL a sev- 
en word first record of the following form* 


LABEL+0 file 

LABFL+2 NAME 
LABEL+4 EXTENSION 
L*BELt6 UIC 

LABELM0 PROTECT CODE (BYTE) 
LABEL+11 UNUSED (BYTE) 

LABEL* 1 2 DATE CREATED 
LABEL+14 unused 


When special Functions involving the operation of magnetic 
tape are reouested of the mag tape driver a Soeelal Function 
Block Is used for Information transfer. A pointer, to the 
soeelal functions block is passed t© the driver in DDB*2, 
The Soeelal Function Block has the following form* 


SFBLK+0 Soeelal Function Code Bvte 

1. Rewind Tape And Unload 
?, Write End of File 

3, Rewind Tape 

4, Skip Records 

5, Backspace Records 

6, Set Density And Parity 

7, Taoa Unit Status 


V . 
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SFBLKel 

Words to Follow (3 or larger) 

Bvte 

sfblk+2 

Tape Unit Status 

Word 

9FBLK+4 

User Specified Count or Control 
Informat i on 

Word 

SFPLKefi 

Residue Count 

Word 


The allowable functions Involving operation of *aqnet1e Tape 
are Hated below and ara described In detail In the follow" 
Ing two sections. 

Standard Monitor Functional 

.OPENI 

.OPENE 

.OPEND 

.OPENC 

.close 

.BEAD 

.WRITE 

.TRAN 

Soeelal Functions 

REWIND AND UNLOAD 
WRITE END OF FILE 
REWIND 

SKIP RECORDS 
BACKSPACE RECORDS 
SET DENSITY AND PARITY 
RFAD TAPE UNIT STATUS 


4.7.1 Opening Files on Magnetic Taos 


(MTO) 


This routine Is called from the Common Open Pneeesser only! 
when an OPENI, OPENO, OPENC or OPENE is reauasted for mag- 
netic tape, OpENU to magnetic tape Is illegal heeauee It Is 
Inconsistent with magtape structure* If this is attempted It 
la releeted bv the Common Ooen Processor, Thg magnetic tape 
Open module Is called fro" coda executed In tha DDB, out 
there bv the Common Ooen Processor, This Is to avoid exe- 
cuting an E M T In the Swap Buffer, 

The function of this module Is to perform soeelal OPEN fea- 
tures for Magnetic Taoe, The Ooen Functions include rewind- 
ing the tape# and cheeking If the deviee .Is already open. 
If the OPEN Is for output proeesalnq it cheeks the Write 
Lock Bit, If the write Lock Bit la on when ooenlng for out- 
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put* an action monitor request will ba Issued to Insert the 
F i 1 • orotget ring before continuing. The routine than leoka 
at tha. first record of each file* comparing the fila nama* 
extension and UIC of the label with tha OPE m reouest Infer* 
motion, until a match 1$ made or the logical end of taea la 
reached. 

OPEN I • This open requires that the Fjle be found. If not 
found* thle la. an error. Exit la taken through the 
addreaa In the file name block. If there* or through 
the Error Olaeneotle Print* otherwise. 

OPENE • If the File la found the taea will skip to tha and 
of the Fjle, If the File is not fou^d the File la* 
bel la written ever the logical end of tape (LEOT). 

OPENO - If the File la found, an aetlon dlaonoatle ia laaued 
at this oolnt. A new tape mgv be mounted and the 
search re*oecura or a continue is given without re* 
placing the tape and the OPEN behaves as If It Just 
wrote the File label. If the File Is not found the 
file label is written ever the looleal end of tape 
(LEOT), 

OPENC • Same as OPENE except if the file ia found It does 
not skip to the end of file. 

OPENU - Illeoal 

Calling Seaueneet 

Registers ere set as follows when this routine is 
cal 1 ed, 

R0 • DOB Address 

R2 * File Name Block Address 

R4 - Device Driver Address 

The following Is the instruction seauenee to call 
the MTO routine from the Common Open Processor, bv 
execution of eode In the DDB, R3 points to 
DDBf3&. RB points to the Swap Buffer "in use" 
bvte, 

FOV EMT+63.-(R3) 

TSTB BR5 
BEQ ,♦« 

FOV (PC)+,-(P3) 

DECB fR5 
FOV R3* PC 

The shove seauenee of code proceeds as follows* 

An EMT 63 is out Into DDB+26. Then a residency cheek Is 
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made to determine if. the Common OPen Processor is in the 
8wao Puffer. If it ie in the Sweo Puffer e second instrue- 
Hon ie put in. the DOB at DOP+24. The eeeond instruction 
free* the Swao Buffer before the EMT is issued* Now the DOB 
address where the code is to be executed is put into the PC* 
Then the code in the DDB is executed* 

Return Aroumentsi 

None 

Deaer i pt i on i 

Whan this routine is first entered the Monitor Register Re- 
store Routine is celled to Perform its funetign of restoring 
the general registers. The word eount for Pile Labels is 
set in the .DOB* The Maq Taos Ooen Routine then builds a 
Special Function Bloch and outs its address in 0DBf2, This 
is to enable the Open routine to reguest special functions 
direetlv from the magnetic tecs driver, A test is then made 
to see if the deviee is OPEN. If the deviee is OPEN* the 
error return address is taken If one was set yP* otherwise a 
fatal error diagnostic is printed by the monitor. If the 
device was not open then a special function call is Issued 
direetlv to the deviee handler* te rewind the tap# to the 
beginning of taee marker (BOT)* A test is made te see if 
the reouest was an OPEN for output* If OPEN for Output a 
test is made if Write Lock is on* if n©t on* continue* if 
Write Lock on then an action diagnostic is printed. When 
the program continues after setion massage the eheek is made 
again. 

Now s Label Block is built from information in the File Name 
Bleeki this includes Filename* extension* IJIC and protect 
eode* The erection date is then set in the Label Bloek, A 
check is made to see if there. was an assignment* end i f an 
assignment was made this over-rides th© file name bloek in- 
formation. The over-riding information is than put into the 
Label Bloek. A search is then made of the existing files on 
the tans bv comoarino the Open reouest file name* extension 
and UIC with the Label Records on the tape. 

If a match is not made on the First Label Reeord* the file 
is skipped by a special function call to the driver* end the 
next label record is need end a match attempted. If the 
logical end of Tape is detected before a match is made* the 
search is terminated, A test is made to see if the logical 
end of tape occurred after the physical end of taoe* and if 
it did an error occurred. The error return address is taken 
if one was set up* otherwise a Fatal error diagnostic is 
printed bv the Monitor, If LEOT occurred before physical 
end nf taoe the tape is back spaced bv a special functions 
eell end a test is made if the OPEN reouest was an OPENI, 
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If the reouest was an OPENI the flit must ha found* so an 
error Is detected If not found. If an error $he aprer re- 
turn address la takan If sat upi otherwise a fatal apnon di- 
agnostic i s prlntad, If the reouest was an 0 *EnE, PPENO op 
OPENC tha Label Paeopd built In core is written even the 
logical and of taoa. The Open Flaos are sat in the Driver 
and tha DDB, Tha staek is elaanad up and tha eommon exit 
routine la taken back to tha usap. 

If a LAPEL PacoPd la found to match the Oeen reouest Infor- 
nation, than tha type. of Open Is decoded*. Pop an OPENO If a 
mateh was made an action diagnostic Is arinted to allow a 
now taoa to be put on and tha saapeh procedure to re-occur. 
If a new taoa Is not out on and continuation is reouested 
OPEN behaves as if It lust wpote the file label, the eaan 
flaos ape sat and the poutlne petupns to tha usap thpough 
tha eommon exit poutinf. Fop an OPENI op OPPNC, the Oaan 
Flaos apa sat, tha stack la elaanad up, and the poutlne ex- 
its baek to the usap. Fop an OPENE, a special function Is 
issued to akfo records to. tha and of file marker, and than 
anothep aaaeial function is issued to beekaaaee evap tha and 
of file, mepkaP, The Open Flaos sps sat and the poutlne pe- 
tupns to tha usap via the eommon exit poutlne. 


4.7.2 Special Operations 


The soeeljl functions appropriate to M a qnetie Tape described 
in the Introduction to Section 4,7 are called bv means of 
tha general routine SPC described In Section 3,4,1, In this 
case, tha eall sequence uses tha address of a Special Func- 
tions Bloek as its second argument, where tha Sleek Itself 
Is sat up as noted, i.a. 

NOV PSPFBLK, • ( 8P) IPA3S SpF BLOCK,., 

MOV PLNKBLK,-(3P) t,,, LINK-BLOCK 
E M T 12 I CALL SPC 

The processing carried out by the magnetic Tape Driver Is 
examined in Its description the T M 11/Tul0 Magteoe Driver do- 
cument ( DEC-1 1-PIM0-D), assumine that a valid code is olven 
In the Block, On completion, control returns to the eelllnq 
prooram, through the Special Functions general routine, with 
data set into the Bloek as followsi 
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1. Taoe Unit Status (SPFBLK+2) 

PITS CONTENT 

P-2 Lsst Command 

0 ■ Offline 

1 ■ Read 

2 ■ Wr 1 t e 

3 ■ Write EPF 

4 ■ Rewind 

5 ■ Sklo Peeord 

6 • Backspace Record 

3-0 unused 

7 1 ■ Tape often FOF (before EOF if 
last command was Bs p ) 

8 la Tape at BOT marker 

9 1 ■ Tape often EOT marker 

10 1 a. Write Lock on 

11 Parity 0 ■ odd, 1 ■ even (default ■ odd) 

12 0 ■ 9 traekt 1 a 7 track 

13—14 Density 0 ■ 200 BpI 

1 a 556 BPI 

2 a 800 BPI 

3 a 80P BpI dump mode 

Motel Tape unit .status is returned in SFBLK+2 
for all soeeial functions. 

2. Residue Count 

When soeeial function reauests are Issued to skip 
records on backspace records and the skip or baek 
space count is not satisfied before termination, 
the residue is returned to tWe "Residue Count" word 
(SFBLKT0). Refer to description of SKIP RECORDS 
and BACKSPACE RECORDS. 
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Fig. 4-1* Linked File Format 
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Fig. 4-5 * User File Directory Block 



Fig. 4-6 « Bit-map Segment Format 
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Fig, 4-10: Possible Linked File on DECtape 
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(Reserved for Bootstrap) 


USER 

LINKED 

FILES 


FILE #1 BIT-MAP 


USER 

LINKED 

FILES 


FILE #2 BIT-MAP 


FILE MAPS i ± - 7 

8 - 14 

15 - 21 
22-28 


- - - 29-35 


36-42 


FILE *7 BIT-MAP 




BLOCK #1 


MFD BLOCK *2 

UFD BLOCK *1 
UFD BLOCK#2 
ASTER BIT MAP 

USER 

LINKED 

FILES 



Block #lSf2i- 
( 9-vord 
entries) 


FILE 


FILE 


#1 ENTRY 


*Z ENTRY 


FILE *3 ENTRY 
FILE #4 ENTRY 
~FILE #5~ENTRY 
FILE #6 ENTRY 
FILE~ *7 ENTRY 
FILE #8 ENTRY 


FILE #25 ENTRY 
~FILE #26 ENTRY 
FILE #27 ENTRY ~ 

FILE #28 ENTRY 


--(Spare) 


Fig.4-lli DECtape Format 
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MON ITOR FILE - MANAGEMENT NODULES 


NAME 

PURPOSE EMT CODE 

CATEGORY 

DTR 

Check Directory Status 

14 

1 

ALO 

Allocate Contiguous File 

15 

1 

REN 

Rename File 

20 

1 

DEL 

Delete File 

21 

1 

APP 

Append File # A # to File 'B* 

22 

1 

PRO 

Keep File on Log-out 

24 

1 

FOP 

Open File (I, E, U & C) 

43 

2 

FOR 

Create Linked File 

44 

2 

FCL 

Close File 

45 

2 

LUK 

Search Directory 

46 

3 

LBA 

Allocate Linked Block 

47 

3 

GMA 

Get Bit-map into Core 

50 

3 

CBA 

Get contigous blocks 

51 

4 

CKX 

Check Access Privileges 

52 

3 

DLN 

Complete Linked file delete 

53 

4 

DCN 

Complete Contiguous file delete 

54 

4 

AP2 

Complete DEC tape Append 

55 

4 


Fig. 4-12 
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FILBLKl 


ERROR RETURN ADDRESS 

ERROR STATUS [ HOW OPEN CODE 

FILE-NAME 

(in Radix-500 

EXTENSION (in Radix-50f) 

USER IDENTI FI CATION CODE 
(spare) J PROTECTION CODE 


Fig. 4-15 i User File Block 
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0 

2 
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r' 
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i 

-i 


NEXT BLOCK # 

* T ~ 


HOW OPEN CODB 


TYPE 


EXTENSION START BLOCK * 
I (spare) 


10f 

(spare) 

12 

START BLOCK # 

14 

# Of BLOCKS 

16 

LAST BLOCK # 

20 

INDEX INTO DIRECTORY BLOCK 

22 

DIRECTORY BLOCK # 

24 

(spare) | PROTECTION CODE 

26 

INTERLEAVE FACTOR 

30 

BIT-MAP POINTER 

32 

BIT-MAP Q LINK 

34 

TEMPORARY 

36 

WORK-SPACE 


Fig. 4-16 t File Information Block 
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CHAPTER 5 

OTHER PROGRAM SERVICES 


As well ss asslstlna the user In handl Ing I/0_ as described 
in the„1aat two ehaptepa* the DOS Monlton offeps a panae of 
othep ppoapam sepvlees aueh as loading and unloading the 
ppoapam Itself and some genepal utilities. As with I/O sep« 
vices. fseh oDePat 1 on Is bandied b v a oanticulap module, 
whleh ,1s noPmally bpouaht fp©m the svatem-devlee wh«n p#» 
gulped op.esn be Pesldent.ln memopy. The oupposo of this 
eheotep Is to desepibe eaeh of these modules* 

•eetlen 5.1 Illustrates the ppoeesa bv which a opogpam Is 
bPOug.ht Into eoPe feHowine s console RUN op GET command. 
Section 5*2 and 3*3 dleeusa the utility oaewaaes allowlna 
the user to, obtain SVT Information and fop some, common nadlx 
conversions. The Command, Stpino Intepppeter which ppovldes 
a fupthep means f op . dev 1 ca-ass i onment while the ppogpam Is 
actually undeP execution, la the subject of section 5,4. 
finally the.ppocess of unloading the orognam upon completion 
Is eovePed In section 5.5. 

Since all the_modu1ea In the catedony ane potential usops of 
the Swap Buffep, thev use the teehnlaups noted In section 
2.3.5, Unless these teehnlaues ape PaPtlculaMy pelevant, 
no fupthep pefenenee to them will be made. 
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5.1 Program Leading 


All programs which run under DOS# Including the Svsteme Prg- 
gpipi themselves# ip« stored# peaepdlees of the devlee# in 
the l 9 ad format Into which they ane eonvented bv LINK-11. 
This is done for two mein reasons! 

a. It follows. the eeneeet of dev 1 ee- 1 ndependenee 
discussed in chanter 3 In that loading from any 
source Is possible, while In most cases users 
ere expected to hold their programs on some 
form of bulk-ateraoe medium# for which a 
eore-1maoe, would produce a faster load# It Is 
still oossible that oaoer-tape or cards might 
be used. Unlike the others# neither reader of 
these letter media provides env form of oueran- 
tee on the accuracy of the data# e particularly 
important reauirement when that data Is an exe- 
cutable program. Instead# cheeking must be 
done by software end the formatted binary mode 
used for the load. image amply enables thle. 
For simplicity therefore ell devices are han- 
dled simi 1 arly. 

b. Even on the bulk-stoneoe media# there are ad- 
vantages In beino able to maintajn the programs 
as linked files rather then contiguous as Im- 
plied by core-image format. Thev can be stored 
on any part of the medium rather thgn rlaldjy 
at pne end (especially significant If the medi- 
um Is DECtapeJi they can be extended without 
the probability of wastage of the medium be- 
cause the old area Is no longer large enough 
and a new one must be orovided# leaving the 
other possibly loeked out of further effective 
use. Also of course# a further step In program 
preparation is avoided# admittedly at the ex- 
pense of e sllohtlv longer lead-time. 

Beforg the Loader itself is discussed .It Is worthwhile 
therefore to examine. the load-format as it Is currently de- 
fined. The Illustration at figure 5-1 shows the structure 
of a tyoical execytable prooram module, Basleallv It con- 
sists of a series of formatted binary bleeks# each starting 
with the two words of header information - mode and size • 
and ending with the checksum the format Implies. (see section 
3. 2. 2.1), The first data word of each block is a load ad- 
dress for the words which follow. The first block of the 
module Is ., a Commun 1 eat 1 on Directory ( COMD) . This contains 
general Information including the program name# Its load and 
start addresses and size? this information mey be followed 
bv a list of EHT eodes taken from the Monitor Library on the 
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evsten-devlee bv LINK11 because thev correspond to Monitor 
(nodules fop which the prooram h#s specified eore- res 1 denpy 
bv global refepenee (see section 2.1,4), (Tf this list Is 
too, Iona for the 128-byte maximum buffer slse^of LINK-11 a 
second block may be used). The ppoapam Itself uses the sub- 
sequent bleeks and finally a single-word Transfer Block pro- 
vides a possible automatic start address (If included In the 
.END statement in the ppoopem Bounce - op 1 bv default) (1) 

Loadl nq aetual 1 v baolns In the transient Mgnitor seetlon 
which. oepuolee memory in the absence of any usep opogram 
(see section 6,5). This poutine Processes the console PUN 
and GET commands requesting the lead and eepfopms the fel- 
lowino initial eoepationsi 

1, Verify the existence of the specified ppoopem mo- 
dule and If present* read its first papt Into a 
buffer of standapd alee fop the device* claimed 
from fpae core, 

2, Transfer appropriate data from the COMD general in- 
formation section into the SVT (see section 2,1,1) 

3, Hove onto the stacks 

a, Ppooram start address or 0 to signify PUN or 
GET 

b. The list of thp Monitor modules to be loaded 
(If anv olven In the C°MD) 

e. Count of the Items in the list - op 0 

d, Ppogpam load address 

4, Sat registers es follows* 

P0 a Address.of a DDB established in free core 
to service the load module dataset 
PI « 0 for linked files 1 for contiguous file 
or a. non-f i 1 e-st ruptured device* sign bit 
negative if device is DECtaoe 
02 ■ Start address o* the allocated buffer 


1, Thp format described in feet is exaetlv the same as that 
prescribed fop the Absolute Loader In the Paqer-teee System 
on PDP-11 (see DEC-1 1-GGPC-D) . Henee* LINK-tl output can 
also be used outside the DOS environment assuming of eourse 
that no. Monitor modules are soee 1 f 1 ed. In this ease* the 
COHD is al so . 1 rrel event s however* because this is given the 
same load Point as the the proopar it is immediately 
overwritten and In all but very few Instances is no problem. 
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R3 a End address of the buffer 

R4 ■ Addree* of next byte to he processed 
(after COMO blocks) 

R5 a (Currently irrelevant - aaa Section 6.6) 

The rguM*t then ealla the lofder proper to continue the 
transfer of the program itself into memory a* shown below in 
aeetion 0.1.1. Thla in Its turn calls a. further module 
which takes„e*re of the loading of the specified Monitor mo* 
dules and of anv general glean-up In readiness for orogrem 
execution. This is deserlbad in aeetion 5.1.2. 


8.1.1 Program Loader (L^R) 

The Program Loader routine is responsible for transferring 
the program blocks from the load, nodule end storing their 
data in th* eorrept memory locations until the terminal 
transfer block is detected. To avoid an extra buffering 
stage . a"d thereby save time* the transfers are carried out 
bv use of . TRAM rather than .READ. The. Loader itself per- 
forms its own eheeka upon the formatted binary mode of the 
data before it is stored. On completion* the Monitor-module 
Loader ia called to complete the load operation. 

In moft eases* the Loader ia exeeetad to be non-resident end 
in this ease* .1 ike other Monitor module** it ia brought into 
the Swae Buffer when required. Th* same also spoils* 
hpwever. to the .TRAN processor which the Loader ealls aa 
notfd.in th# last paragraph. .The Loader selves the possible 
conflict in a manner similar to that uaed by the 
f i 1 e-manaosment modules. in a like situation^ (see Section 
4.3. 2. )t If* before. it_ beoins its processing* it detect* 
that it, is Jn the. Swae Buffer (by examination of the 'Jsaqe 
Count in its first byte)* it moves itself into another 
buffer claimed from free eore and releases the Swan Buffer 
for the use of . TRAM, 


Calling Seouenee t 

The Loader exoeeta the Register and Stack-state detailed 
above, otherwise its call is merely! 
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Processing! 

The processing sequence followed by the Program Loader is 
illustrated at figure 5.2, Basically the following opera- 
tion* are performed! 
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1, Reset Registers to the valuta oasaed bv the transi- 
ent Monitor. Remove the return PC end Statua fro" 
the stack. 

2, Link tha established DOB# aa shown bv tha eddraaa 
in R0# to an Internal link-bloek In order to pro- 
eeea tha program load modulo aa a dateaet in the 
normal manner (tha link-block uaad by tha transient 
Monitor mav of cpuraa dlaeopeer underneath th# pro- 
or am as it la stored) 

3, From the data In R2#P3 and R* build an aoprooriate 
TRAN-block • alao Include an EOD flag If this Is 
alresdv sat in the DOB (aee section 3.2.1.3) 

A, The eurrpnt ataek mav also be over-written bv tha 
loaded Program# so move the data daased bv tha 
transient Monitor onto a new one aft immediately 
below tha Prdoram Load Addraaa. (This reoulres two 
moves sines there Is always the possibility the eld 
I now areas might overlap one another). 

S, Clear tha whole of memory between the Program Load 
Address and the start of tha area reserved for the 
Paeer-taoe System Loaders. 

S. Ppdeess the data In the buffer# .a byte at a 
time • sinee there la no constraint that binary 
bleeps must be complete words - aa follows! 

a. Look for tha first non-0 bvte, Ifthls Is not 
1 and tha max t not.0 the format is Incorrect! 
so rejeet the load with a fatal Format error 
message (F022) 

b. From the next two bytes# build the Byte Count 
for the number of deta bytes to ha read and in- 
itialise a eheeksum accumulator. 

e. Form tha Load Point for the data. from the next 
two bytes and eat a memory pointer accordingly. 
Adjust the Bvte Count for the six bytes Just 
read. If this is now 0# the block Just ore- 
cessed must be the terminal Transfer Block! 
hence release the dataset linkage and eall the 
Monitor-module Loader (sea next seetlon). 

d. Otherwise store bytes in memory vis the eointer 
set in steo (e) until the Byte Count gees to 0. 

a. During steos (c) and (d) odd each byte Into the 
eheeksum. eeeumul etor, Then add the data eheek- 
sum byte. If the result is 0# return to steo 
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(a) to look for the next date block. 
Otherwise# etes the lead with a fatal Chaeksgm 
error (F*21) 

7. If# aftep any byte haa been Processed in tha previ- 
out operation# the datf buffer la seen to be empty# 
call the device to refill it as follows! 

a. Cheek for an EOO seen at tha last deviee 
tpansfep bv fxamination of the TRAN-bleek flaq. 
Since a terminal Tpansfep Bloek should come 
first# this must be an. error# so reject the lo- 
ad on the oppunds of incorrect format as in 
steo 6(a) above, 

b, Using the flag sat Into Pi whan called# cheek 
if the load module is a linked file* as des- 
cribed 1? section 4,1, l.l, If not# increment 
the device bloek number in the TRAN-bloek, 
Otherwise extract and store the first word of 
the date-buffer as the deviee block# If this 
Is negative and the deviee Is DECtaee# (see 
seetlon 4.3.2)# turn it positive but set the 
TRAN-bl ock flao to fores reverse tape motion, 

e. Call ,TRAN# followed bv ,wAIT, On completion# 
stop the .load as in step 6(e) above# If any 
deviee psritv failure ha* been detected as 
shown bv tha TRAN-bleek flag. .Otherwise adjust 
the buffer sod pointer for an incomplete bloek 
trenafer if this is signalled In the 
TRAN-bl ock. Reset the bvte-ext raet 1 on pelntar# 
skipping tha first word if soaln tha Input Is a 
linked file# and continue. 


Exit States 

When the module performing the final load phase is called# 
the contents of Registers are of no eonseoueneei the etaek 
remal ns .as. on entry except for the Program Load Addrass en- 
try which is removed during the processing. 


Comments* 

It will be noted# perhaps. that tha loader module does not# 
at step 6(e)# attempt. to release the buffer It may itself be 
occupying. At this time any buffer allocation eeases to ba 
meanlnpfu). As was shown in. section 2.4.2# the memory arpa 
controlled by tha Monitor Buffer Allocation Table Is orl- 
ginad elwava at tha currant end of the resident Monitor, 
During the next load Phase# this end is likelv to move up 
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memorv to include further modults reouested bv the oroqpim 
end, the. free eore area is. .then different. Henee, the Buffer 
Allocation Table, it cleaned by the next nodule and this au- 
tomatically reclaims outatandino buffere. In fact#, the coll 
to release the input dataset is made purely as a simple way 
of cleaning the monitor DDB chain (see section 3,1,2,3) and 
the DOL entry for the input device (aee section 2,1,3), 

This module cannot be re-entrant, because of t h ® link- end 
TRAN-bloeka it must aft uo internally, However by itf na- 
turef^uch reouirement is, irrelevant, likewise, there is no 
restriction, on its residency, for its current purpose, 
(thouoh IT is.perhaoa inconceivable that there is eny point 
in its beino in core other then whan reouired). 


8,1.2 Monitor H 0 du1e loader (IP2) 

The lead process Performs two main functional 

a. It extends the resident Monitor to include the 
edditional , modules specified bv the program and 
eurrentlv identified bv their EMT eodes in the 
list on the steek passed bv the transient Moni- 
tor, 

b. It ensures that the Monitor is eorreetly primed 
for the program execution run and if raouirad 
automat ieal 1 v beoins the run. 

In t hi s .part i cul ar case, anv transfer from the system-device 
in order to lead a raouirad Monitor routine is controlled bv 
the loader module* using its own internal 0D8, Since the 
loaded routine would overlev anv buffer allocated fnom the 
than free corf* the module eannot repeat the teehnioue 
adopted by its predecessor to use ,TRAN» as shown in the 
last aeetion.. The whole operation must be effected within 
the. Swao Suffer, This of course means that re-entraney is 
again oyt of the question, The remarks on the last ears* 
graoh of seetion 5,1,1 still applv. 


Calling Seouencei 

As noted in the previous seetion, this module expects a 
stack-state as Passed by the transient Monitor seetion, 
etartjno with, the count, of Monitor modules to be loaded. No 
additional Information is needed. Hence its eall 1st 
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Proeeseinoi 

The processing sequence In this em i • relatively simple* 
No . 1 1 lustration is therefore included. Basically the fol- 
lowino steps sre taken* 

1, Remove the date oushed bv the EMT eell from the 
stack# i.e. saved reoister contents end return PC 
end Status. 

2, Clear the Monitor Buffer Allocation Table complete* 
ly (see section 2.4,2) end reset the TOB entry In 
the SVT end eorreadondi no stack-stop (Lowest allow- 
able address for staek expansion) to remove any 
buffers still allocated (see section 2.1.1 end 
"Comments" in the previous section). 

3, Collect from the steek the eount of. Monitor rou- 
tines to be leaded end if sere# proceed to step 9. 
Otherwise determine $he address of the 
eystem-deviee driver via the DDL start stored in 
the SVT end put it Into an Internal DDR (see Sec- 
tion 3.1.2.3). Also set the DDB Completion Return 
to, use the same seouenee as Sam for dequeuing the 
driver vlf 8. COO. eheekina the transfer validity 
end elearlno the DDB busy state (see Section 
2.3.4). 

4, Using the EMT code passed on the steek. extract the 
eorrpsoondino MRT gntrv for e reouired routine (see 
seetlen 2.1.2). If the value eolleeted. Is even, 
the routine is already resident, so lonore the re- 
quest and oo for the next. 

3, Otherwise compute the site of the routine from the 
MRT date end adjust the SVT entries for E0 M l TOB 
(sod Its stsek-steo) accordingly, 

5, Prepare the DDB for the transfer, setting its Busy 
Flag end using the mpt data to store Davies Block * 
and Word Count end the old EOm for Buffer Address. 
Also make the MRT entry show the routine's start 
address now that It will be resident. (Because of 
the Useoe Count. 4 Reentranev Switches In the first 
word. of the routine# this must be old EOM+2. (see 
section 2,3.2) ) 

7 , Save current Regi stars and call the system-device 
driver to effeet the transfer, vie S.CDB (see sec- 
tion 3.1. 2.4), Request .WAIT until dome (as indi- 
cated by the DDB becoming idle because of step 3), 
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8. Restore the saved Reolsters and if (He count shews 
that mo na Monitor routines remain to be loaded* re- 
turn to step 4. 

9, Make a final adjustment to EOm# T09 and staek-stoo 
to reserve two words for Device Assignment Table 
linkage (see seetlona 3. 2,1,2 and 6.4,10), Also 
ensure that the SVT entry for WRA ooints to the 
Syatem Walt Loop (aae section 2,1,1). 

10, Simulate a normal System Exit for a routine uslna 

the Swao Buffer (fee section 2,3,4) end allowlna 
for the user's soeei fleet Ion for RUN or GET as fol- 
Iowa* * 

a. Return Status - move the RUN/GET swlteh passed 
by the _ transient Monitor up the staek and in- 
sert 0 to foree no priority level, 

b. Return, PC • If the RUN-GET switch is non-0# the 
valu* is the automatic start address* hence the 
correct exit point (1), Otherwise replace the 
switch by the address of the System Welt Loop 
to foree the necessary GET state. 

e. Saved Resistors - dear the next, 6 words on the 
stack to represent R0 through R5*. 

11, Sa,t the Monitor/Uaer swlteh (MUS) In the SVT to 
shew eerreet state (see Seetlon 2,1,13 s 

a. Program jn and Running (1,1) for. RUN 

b. Program In but Waiting (-1*1) for GET 

12, Also for GET# force aeeeotanee. of keyboard command 
incut by setting the Listener inout underway switch 
(see section 6,3*1) and output 'S' to inform the 
operator that aueh Input ie exeeeted. 

13, Taka. the System Exit to release the Swap Buffer and 
continue as sat in step 10. with Registers cleared 
and the stack starting Immediately below the 1 oaded 
Program, 


1, If the .END statement in the orogram souree did not# In 
fact#, suoply a start-point* this Is set to If hence the au- 
tomatic start results In a fatal error (F342) because this 
is an illegal address. The user ean reeouo by means of a 
keyboard BEGIN with the eorreet address supolied. 
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5«2 General Utilities Package 


( 6UT) 


As noted in section 2.1.1* the Monitor rataina system-state 
Information in the 8VT. In addition, the TRAP instruction 
has been reserved. for. the user* its vector Is also within 
the resident Monitor. In order to allow the user to aeeess 
this area* a General Utilities oaekaga is provided. While 
this is perhaos unnecessary under the present DOS because 
the use? cannot be denied. such aeeess If he. chooses to go 
more dlreetlv* later systems developed foe a PDP-11 with 
possible hardware protection might prevent this. Moreover 
It eannet be. guarantee^ that those. svstema will necessarily 
structure their Information tables In the seme wav. Thus In 
the interest of upward compatibility# access through the 
Utilities paekage Is strongly recommended. 


Cel 1 1 ng Sequences 

The paekaoe Is eelled bv a single EMT (41)* to identify a 
particular function an identifier eode is. passed as a call 
argument. Basleellv the functions ean be divided into two 
main groups and the eodes refleet this. Eeeh group also has 
a different celling sequences 

a. PUT funet1onf (1-77) -In which the user Is supply* 
jnp information for appropriate storage by th# Mon- 
itor* For these* the user pushes both the Informa- 
tion end the eode as eel 1 arguments* thy Monitor 
returns eontrol to the program on eomdletion with 
the ataek eleer, e.g.s 


MOV 

«DATA#-(SP) 

* PASS INFO FOR STORAGE 

MOV 

•CODE.-(SP) 

»... 4 IDENTIFIER 

EMT 

41 

ICALL GUT 


b. SET functions (1*50-177) - by whleh the user asks 
for information already stored* In their ease# the 
user provides only the identifier in the cell* the 
Monitor returns the reoulred .Information on the 
staek with the user then responsible for Its remo- 
val S 


MOV *C0DE,-(SP) *PA9S IDENTIFIER 

EMT 41 ICALL GUT 

The currently assigned eodes and their ealllna seouenees are 
shown in the Programmer’s Handbook, 
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Proeesal not 

Th# processing seauenee for GUT is illustrated at figure 
5-3. Th# baalc ataea ara aa follows! 

1, For coda 1* (Sat trap vaetor) • move th# supplied 
PC and Statua into th# vaetor in locations 34 l 36# 
dear three areuments from the ataek and take a 
normal System Exit to free. the Swao Puffer If ne- 
eaasarv and restore user Registers. 

2, For coda 2. (Sat RESTART address) * move tha sup- 
plied address into th# SVT for possible later use 
by tha eonsol# RESTART command (sea section 6.4,5)# 
elear two arguments from tha ataek and taka a nor- 
mal System Exit. 

3, For all GET eodea - set a pointer to tha SVT start 
from tha content. of its vector In location 40 and 
reduee the Identifier coda to an Index. Cheek its 
range and if It represents an unasslonad value# 
eall a fatal error (F002), 

4, Otherwise use the index to eolleet from a table of 
offsets tha one relevant to the SVT entry required 
bv the user. Reolace tha eall eode on tha.staek by 
the Information, to be returned and again take a 
normal Svstem Exit. 

5, Presently two GET functions reouire special treat- 
ment i 

a. Coda 104 (TOD reguest) - two words must be re- 
turned# hanea move tha saved Registers and re- 
turn parameters up th# st#ek to provide neces- 
sary space. 

h. Coda 1&6 (Svatam-devi ca name) • this Informa- 
tion is in the DDL# hence use the SVT pointer 
to collect It from th# first DDL word (see sec- 
tion 2.1.3). 


Comments | 

The General Utilities paekaoe.is completely ne-entrent and 
may be resident without restriction. 
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5.3 Conversion UtTHtj ea Packag e 


(CVT) 


Comjonl y-ueed sub-routines for converting an appropriate 
atrlna of ASCII characters or similar non-binarv values Into 
a binary quantity • or vice versa - are provided as a oaek- 
aae within one Monitor module. Currently this oeekeqe el* 
Iowa for alngl e-oreel alon binary conversions only. This au- 
tomatically ore-determinea the length of eaeh string, as 
shown bv the following list of the routines available! 

a. Padlx-50 paek & unpaek * 3 bytes 

b. Decimal ASCII diolta to/from binary • 5 bytes 

e, Oetel ASCII dlalts to/from binary - 5 bytes 

However on Inout thja lenath is only deemed s maximum! the 
format of the string can cause the conversion to stop with 
the. result at that point meeninoful to the user, Am outout 
strino nevertheless always produces the fixed number of 
bvtee, .In general# error conditions detected during a 
c 9 nverslon ere, reported to the user In the processor condi- 
tion eodeaj It is the user's responsibility to eheek these 
(using BCS»BVC ate) when the program la recalled# e.g. 

C blteinvalld byte entered as input# or produced as 
output 

V bltsinout too large for single-word storage 

Ae with the. General Utilities packed* discussed In the pre- 
vious section# the. conversion routines are celled by e sin- 
gle EMf eode (42) with an Identifier Passed as one of the 
cell .arguments. Similarly there are two basle groups eeeh 
with its own celling sequence end Program reeell state. 
These ere described In sections 5.3.1 and 5.3.2. 

The..who!e pseksae Is reentrant under all conditions and may 
be freely used real de«ce-wl se. 


5.3.1 Conversions To Binary 


Cal 1 1 ng Seaueneet 

The three routines which convert from A8CII strino to binary 
word# ere all assigned even eodes t They require only that 
the user supply the start address of the string since the 
lpnath is fixed for the. conversion as noted In the introduc- 
tion. Henee their calling seguenee Is as follows! 
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MOV 

*ADDR,-(SP) 

(PASS 

STRING START.,. 

MOV 

*C0DE,-(9P) 

' . * *1 

identifier 

EMT 

42 

■ CALL 

CVT 


Exit 

When ,the pregpam is recalled, the eonyerpion . replaces the 
code on top o f the stack and the address Is undated to Point 
to tha byte following the last one included In the conver- 
sion* The returned vel ue. i a besed upon all the bvtes seen 
up to_ao invalid one or until overflow, subjeet to tha maxi- 
mum for the Particular conversion. It is always correct up 
to tha point of stoppage* For example, if the string 
'61*63,60,19' ( i ,e, 10P<CR>) Is converted from decimal ASCII, 
the binary result is 300144 with tha address returned on the 
stack beino that for tha eCRx.bvte. As mentioned earlier, 
howevfr, the C bit is also set in this ease to indicate the 
invalid input. 


Proeossinat 

# . * . 

Certain operations ar* eommon to .all three . eonvers i ons i 
therefore a coroutining teehnigue is used. This is similar 
to thpt, described for the .READ/, WRITE processor in section 
3.2.2. 2. The seguenee followed by the mainetreem is dee* 
eribed belowj the unioue sections for each conversion are 
shown. in sections 5.3.1.1 through 5.3.I.3. The whole module 
is further illustrated at figure S»4, 

1. Upe e dispatch sequence eommon to all tha eonver- 

sion routines in order toi 

e. Clear the condition codes from the return 
status in anticipation of no errors 

b. Extract two eall arguments and leave a Pointer 
to their stack position 

e. Build the address of the first return point to 
the mainstream on too of the ataek. 

d. Cheek the validity of the identifier eode - if 
not asaianed call fatal error (F&34) 

e. Using the eode as an index into a JMP-teble, go 
to the unioue routine to set a bvte counter for 
the appropriate maximum string-length, 

2. On. return, clear the code word on the stack as the 

store for the accumulated result. 
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3. Collect a byte from the string# remove parity (bit 
7) and reduce to numeric digit range, Return to 
the unique routine for further cheeking and oerhaos 
adluetment* 

A, Ueina a common sequence with variable return oo- 
inta# multlolv the present result by e factor ap- 
propriate to each conversion (i.e. 50 (octal) for 

radls-oeeklne# IP for decimal and 4 for oetal CD). 
Add In the new bvte. 

S. If a chec,k, on the count shows further bytes .remain 
te be processed* return to step 3. ntherwiae up- 
date the strino pointer on the etaek to show the 
nfict bvte to be Processed, Remove the co-routine 
link from the steck end take a normal System E*it 
to, free the Swap Buffer if neeessery and reeel 1 the 
program. 


5, 3, 1.1 Radix-50 Pack (code 0) 

This form of eonvers 1 on, el 1 owe the restricted set of char- 
acters normally used for,evmbolie names to be stored In one 
word* three at a time* using the algorithm! 

50(5f*A+B)*C 

where. 5? is ectellv based and A* B A C are the thrge char- 
acters eoded in accordance with the following tablet 


0 > SPACE 

1-32 a A-2 

33 i ! 

34 a , 

39 (unused) 

36-47 • P-9 


This conversion Is stepped therefore after three bytes or 
upon recognition of a character not included In this set, 
Xn the. letter ease* however* the result must be 
left-lusti fled, I.e. 'A' Is equivalent to 'A ', Hence the 


l« The oetsl conversion unique rout 1 ne. al ready has doubled 
to present result (see section 5, 3,1.3), 
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un4ou« routine called bv the mainstream listed above Dee- 
forma the following operations* 

1. On entry set the count for three bvtea and recall 
the mainstream for the first bvte, 

2, Convert a valid byte in accordance with the table 
and return to the mainstream for multiplication of 
the current result bv octal 50 and addition of the 
new value. Recast if recalled with another byte, 

5, Hold the. string pointer at an invalid byte end set 
the .C bit in the program Status saved on the staek 
to signal the error, ReDlaea the byte with 0 and 
eontjnue from step 2 to force the reouired left 
I ust i f i cat i on. 


5,3, 1.2 Decimal ASCII To Binary (code 2) 

The conversion of decimal digits uses the standard algorithm 
in whieh a previously computed result is multiplied bv deci- 
mal l 91 «nd is thfn augmented by a new digit* always leaving 
a correct value if stopped at any time, e.g.t 

Result #1 m A 
Result 02 • 10A+B 
Result #3 ■ 1P(10UB)*C 
ate. 

The maximum decimal value that earn he stored in a single 
word is of course 65535, Hence the unique routine must en- 
sure that this is not exceeded as follows! 

1, Set the counter for five bytes and recall the main- 
stream for the first bvte, 

2, Verify that the byte is a valid decimal dioit, If 
not# hold the string pointer at the incorrect bvte 
aind signal the error bv settina the C bit in the 
program Status saved on the stack. Exit through 
step 5 in the mainstream, 

3, Cheek if the currently accumulated value is 6553, 
If less* or if, eauel wfth e new dioit not greater 
than 5* return to the mainstream for multiplication 
of the present result and addition of the new di- 
git, Reoeat from step 2 if recalled with another 
byte, 

4, If the overflow condition is seem in stee 3* hold 
the strino pointer at the current byte* set the V 
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bit in the saved, program Status and exit throuqh 
step 5 In the mai nst ream. 


5.3. 1.3 Octal ASCII To Binary (code 4) 


The convention of octal values uses th e same algorithm as In 
the orevlous section exeeDt that the mul t iol leat Ion faetor 
Is octal 10 rather than decimal. If the computation is 
stooped gt, snv time#, the last result Is again valid. An 
overflow eroblem also exists* the unloue routine In this 
case therefore cheeks that the result dees not bseem# ore* 
star then octal 177777 as follows* 

1. Set the counter for six dlalta and recall the main- 
stream for the first bvte. 

2. Verify that the byte Is a valid oetal digit, If 
net# exit through step 2 of the decimal routine in 
the previous section to slonal the error. 

3. Cheek if the current result Is greater then octal 
17777, If so# exit through step 4 of the deelmsl 
routine to flag the overflow. Otherwise# double 
the result , and return to the mainstream for its 
further mul 1 1 pi 1 eat 1 on bv 4 and addition of the new 
dielt. If recalled with another byte, reoeat from 
step 2. 


6.3. 2 Conversions From Binary 


Calling Seouemcel 

The, corresoondl ng routine* to convert from binary to ASCII 
string use odd Identifier codes. In their ease not only 
must the user supelv the start of s buffer for the storage 
of the converted bytes but also the binary word to be eon- 
verted, The celling seouenee therefore passes three argu- 
ments as foil ows 1 


MOV #W0R0# - ( SP) 
MOV MDDR#-(SP) 
MOV #C0DE#-(SP) 
EMT 42 


tPASS DATA FOR CONVERSION... 
I... BUFFER START.,. 

»...* identifier 

iCALL CVT 
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Exit Stetei 

On return to the program, the required string Is stored es 
7-bit. ASCII eherseters In the buffer supplied. Its site Is 
the fixed number of bvtes associated with each conversion as 
noted In the Introduction# with appropriate taro padding. 
Hence there Is no need to uodate the buffer pointer returned 
to the user * ha can compute its new position If required. 
Instead* the steak la completely cleared on recall. 


Processing* 

These conversions do not have the same, compatibility as 
their^ counterparts dlseussed In seetlen 5.3.1, They are 
therefore effected In separate subroutines discussed In see* 
tions 5. 3,2,1 through 5, 3, 2,3, However they use the same 
common dlseeteh sequence as that previously described under 
•tee 1 in section 5,3,1 and share a common exit to remove 
the three call arguments from the staek and recall the pro* 
gram through the normal System Exit, 


5,3.2, 1 Radix-50 Unpack (code 1) 

To reoroduee the original characters Packed Into one word In 
accordance with the elaorlthm alven In section 5. 3.1,1, two 
operations are needed! 

a. Successive division of the binary value by oe- 
tal 50 In order to extract the three coded 
bytes, 

b. Conversion of the bytes Into their correspond* 
ino ASCII equivalents. 

The. algorithm used to effect the first of these needs expla- 
nation since It Is not a generally standard one. It is 
bated uoon the feet that 3/16 of a quantity I 9 almost equal 
to byt.ls always, less than. 1/5 of that quantity. This fol- 
lows from the basie algebraic tenet! 

(x-i) (x+l)«x,x 

Thlf fraction therefore provides a reasonable first approxi- 
mation for division bv 5! re-iteration of the same oroeess 
with The remainder (1/16 of the previous value) then enables 
a fairly raold aecymulatlon of the correct result. The 
number of iterations Is. certainly less than those required 
for thf more normal division technique of divisor or divi- 
dend rotation with trial subtraction and, of # course, this 
number reduces with the orlolnal ouentitv unlike in the oth- 
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•r system. Moreover the cop* usage fn both methods fa 
pouahly. the tame. Such useee fa obviously gpeatep than fn 
tha vapv basfe aueceaafve subtpaetion technique but tha time 
taken fop this method doea nipt atand eomeepfson, Hence the 
peduetfen aloopfthm outlined fa adopted because ft fa faatap 
and cuppentfy the ovepall afze of the CVT module fa no opob- 
1 am. 

Tha algorithm above can be applied fn feet to any numbap 
whfeh fa one gpeataP than a b i napy-eewep# e.g., 3,9,17, etc. 
and natuPallv bacomea mope apopoppfate the lapgtp tha 
numbep. 

The aeeond ©pepatfon maPaly Involves eomoapfaon of each byte 
wfth the eoppeapondfng panaea of the table given fn aeetion 
5.3.1. 1* to detepmfne tha ASCII equivalent. Twin pofnta 
howevep ahould be noted! 

a. The maximum acceptable value fop a valid peault 
fa that coppaaoondino to 999. i.e. 174777 (oc - 
tel). If a quantity gpeatep than thfa fa 
oaaaed fop convepsion# the ffpat byte wfth e 
coded value of 58 becomes (») bv the tPanala- 
tfon method used. 

b. *ny of the bvtea can peault in the unuaed eode 
35 whfeh fa tnanelated Into (/) 

In efthgp ease the invalid eheneetep ia petupned to the eal- 
lina opogpam in oPd$p to complete the eenvenaion, The eppop 
ia howevep flagged in the C bit. 

The bvtga ppoduced bv the diviaion ape in the Pevenae opdep 
to that _pequfped bv the final etping. Thua the ataek fa 
uaed to.effeet the neeesa.apv awftch ae indicated fn the fol- 
lowing sequence fop the convepaioni 

1. Set a ataek mapkep at its ppesent position (nega- 
tive value) 

2. Stope the value on the stack and compute 3/16 

(■ (x«x/4) /4) , In the same opeeeaar Peduee the va* 
lue on the ataek to 1/16 (a(x-(xpx/4)-( C*-*/4)4) , 

Sum the ouotfenta as thia atee ia Pepeated until 
the pemafndep on the ataek fella to 47 op below, 

3. Step. 2 opoduees dfvfafon bv 5, _e© divide the quoti- 
ent obtained by oetal 10 end if the second bvte pe- 
mafns to be opoeessed, pepeat step 2 with the pe- 
ault. Othepwiae cheek the peault - now the ffpat 
byte • and aat the C. bit fn the opogpam Status 
saved on the ataek ff opeetep than 47, 
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4, Check If the bvte it the unused eede 35, 1? to 

similarly signal the error. bv the return C bit. 
Convert the byte regardless of any arrer into Its 
ASCII equivalent and store in the user-soee 4 f i ad 
buffer, Collect the next byta from the stack and 
recast this steD until the marker set in step 1 is 
rtaehed, 

5. Take the common exit to elean»uo the stack and re- 
eal 1 the oroarem. 


5, 3, 2. 2 Binary to Decimal ASCII (code 3) 

The. conversion to decimal .ASCII. uses a standard pimple al- 
gorithm whieh needs no exolanation, Moreover no input value 
ean produce. erroneous results. Thus the seauenee for the 
conversion is merely as follows! 

1, Set a pointer to a table of 10-eower values 
( 10000 - 10 ) 

2, Starting from oetal 60 as the necessary ASCII base* 
eount the, number of times eaeh 10-eower value can 
be successfully subtracted from the input quantity 
and pass the, result to the user's buffer. Repeat 
until 10 itself has been used, 

3, The remainder is the digits byte ■ add 60 and pass 

to the user. Take the common exit to elear the 

stack and reeall the program. 


5, 3, 2. 3 Binary to Octal ASCII (code 5) 

Conversion to oetal ASCII is effected bv s i mpi e rot at i on of 
the input value to extract a requisite number of bits (1 for 
the first bvtei 3 for the rest)! to th®se octal, 60 is then 
added as the neeessary ASCII. base for each of the six di- 
gits, Again no errors are possible. The particular algor- 
ithm uses C-bit detection of marker bits set into the rotat- 
ed result-store 4n order to count the. number of £its for 
eaeh dioit and also the number of digits as fellows! 

1. Set a marker bit and, ASCII-base eauivalent for one 

rotation in the Junior byte of a resul t-stera. In 

the hioh-bvte set a marker for 6 rotations. 

2, Rotate a bit from the inout word into the Junior 

byte of the .result until the marker bit moves to 

the C-bit, Store the resulting byte in the user's 
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buffer, 

3. Reset the Junior bvte as In atop 1 for four rata* 
(Iona, Rotate the whole reault word and repeat 
from ateo 2 until the hloh-bvte marker reaches the 
C-blt, Than take the common exit to eleen-uo the 
ateek and recall the program. 


5.4 Comm and 3 1 r1ng_ In ter or e ter 

In chapters, 3 & 4* It was ahown that the uaer haa two normal 
methoda of Indicating the devices and if neeessarv the files 
he wlahea to associate with the dataaeta providing I/O for 
hia proaramat 

a. He een pre-set the neeesaary information Into 
Link-blocks and File-blocks within each program 
source. 

b. He een aupolv thia Information or can override 
that already In the program at load time bv me* 
ana of the console ASSIGN command. 

Bpth methoda ereaume that onee the program has begun execu- 
tion* It wljl need the aeme devleea and fllea for, each run 
wh11e.lt remains loaded In memory. Neither method ia really 
suitable* however* If the, program needs the ability to use 
different I/O medja for. different runs* particularly If the 
new dataset specifications are at the discretion of the op- 
erator at the console keyboard. For the simple eafe* this 
might be managed bv the program setting an appropriate RES- 
TART address (see section 5. 2)» printing some operator aiq- 
nal end then waiting for the input of console ASSIGN and 
RESTART commands to start a new run. For the general ease* 
however* this is elumsv and wasteful I each specification 
needs a.aeparate ASSIGN and uses an Individual 16-word free 
core buffer (see section 3,2,1, 2) 

The Monitor therefore contains a Command String Interpreter 
(CSI) as a means wherebv dataset specif icationa# requested 
and entered.es a string, can be translated and actually 
stored within the erooram Link-blocks and File-blocks In re- 
adiness for each run, Furthermore* moat System Programs 
tvpjeally need this, facility to ehanoe devices end files. 
Their. use of CSI provides the added benefit that thev all 
now present a standard interface to the operator at the key- 
board. 

This interface end the method by which user programs mav al- 
so call for the services of CSI are both fully described In 
the Proarammer'a Handbook. This section thus contains only 
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sufficient _outH"« for Immediate reference. Briefly, the 
proaram performs tha followino operations* 

1. Reou.aat command string Input bverlntlng '** at tha 
console typewriter* call .READ and .WAIT for the 
operator's reply. 

2. Ca,11 a qaneral Svntax Analyser, dlseussed In see* 
tien 5.4.1, to eheek tha overall accuracy of tha 
inout atrlng and aet uo tha decoding phaaa. 

3* Call an individual Dataeet-apeei fleet ion Decoder, 
described in .Section 5.4.2, to aet uo tha 

link-block and File-bloek for each dataaet con- 
cerned* 


6.4.1 Syntax Analyaer (CSX) 

The format specified for a command atrlnq to be preeeaaed by 
CSX It illustrated at figure 5-5. In particular, this shows 
that the specification for each dataset In the string ean 
epneist of a number of elements* however not all need be 
given, but those that are must comply with a set of rules, 
tabulated, at flours. 5-6. It Is the principal function of 
the Svntax Analyser to ensure that these rules are not bro- 
ken and to inform the proaram of infrlnpmgnta If detected. 
Xrt additi®** the Analveer eleana-up the string by removing 
extraneous characters (spaces, TABS, etc.) and fixes the po- 
sition of pointers needed In the deeodlno operations which 
fol low. 


Cal 1 1 ng Seoueneet 

In order to collect the commend string, the proaram reauests 
•READ from the dataset providina the input • usually one as- 
signed to the console keyboard, >s a standard reaulrement 
of thlo I/O function (see section 3, 2.2*2), the proaram sup- 
plies a line buffer for the data, normal lv preceded. Immedi- 
ately by, a 3-word llne-bloek of control inf orm.at ion. For 
the use of Csl* the line buffer with Its header for the In- 
put of. e command string is further preceded by e 7-word 
work-apaee as. shown In flours 5-7, (CSI pssumee that this 
format la followed exeetlv,.end in Particular dees not ex- 
pect the Dump mode described in seetlon 3. 2.2.2.) Menee it 
requires only that the program oass the. start address of the 
workseaee (CMDBUF) as part of Its call in order tie aeeess 
both the workspace and the data in the line, Moreover at 
this stage la la not concerned with the proaram dataset 
linkaaes. Thus the calling seauenee la aimolvt 
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MOV PCMOBUP t PASS W/SPACE ADDRESS 

E M T S6 iCALL CSX 


Censral Description! 

CSX initially preoarea the workspace for later use at dep- 
leted in figure 5-8, The aionifieance of the entries is as 
fol 1 owst 

1, Input/OuTout. Code • enables the program to Identify 
which side of the string is to be used at r th« neat 
reouest for the decoding of a dataset specification 
* see next sections 

2, Current Input Address • shows the start address of 
the next input dataset specification to be pro- 
cessed at any time. , It is initially set at the ad- 
dress of the byte following * < * . 1 f detected# or 0, 
It is updated as each specification is decoded, 

3, Current Output Address, -performs the pane function 
as 2 for output. Its initial setting is the string 
start address, 

A, Current Input Default Device • provides a deviee 
nans when none la entered #s Pert of a specifica- 
tion, The start assumption is the svstem-devleet 
anv new deviee entry overrides the previous default 
(on the inout side only • defaults do net eross the 
boundary) 

5. Current Output Default Device - is the same as 4 
for output, 

8. Current InDut Default Unit • gives the unit number 
if the device can control several. Its initial 
content is 0 snd is uedsted as in 4, 

7, Current Output Default Unit • eauatea to 6 for out- 
put. 
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Having eollapaad the string to show only raeoonitable ehar- 
aetart# CSX oarforms Its necessary checks an the bails of a 
•at of states coppaapondlng to the elements beino scanned. 
Thasa ana as fellows (with their initiating characters)! 

0 ■ Specification Start (#) 

2 ■ Device (latter) 

4 ■ Filename (latter) 

6 • Extension (,) 

5 ■ UIp (I) 

10 a Switch (/) 

12 ■ Inout Side Start («) 

14 a string End (LF.FF*VT) 

Whenever a ounetuetion character In the string denotes tran- 
sition between statea* a table corresponding to the orlor 
state. Is examined* This table gives a Hat, of eunrent 
statM which eannot be geeegted in accordance with the rules 
previously Illustrated In figure 3*6* Upon. detaet Ion of an 
Invalid, state or of a character which Is illegal generally 
or within a state* CSX recalls the program with the address 
of thg byte terminating the scan on top of. the staek. 
Otherwise 0 is returned* It is then the resoone jbi 1 1 ty of 
the Program to eheek the indicator (and remove It from the 
stack) and to take aetlon accordingly* 


Detailed Processing! 

The processing operations of CSX are illustrated at figure 
5-9. The aeouenee of these operations is basically as fol- 
lows! 

1. Collect the start of the workspace CMDPUF and Ini- 
tialise It as noted above - using the DDL entry in 
the SVT to determine the system device (see section 
2,1,1 and 2.1*3). Set pointers and switches 

2* Sean the string and remove seaees* TAP's and ru- 
bouta until a valid Una terminator is seen* 

3, Ignore '*' and remain at state 0 until some other 
character Is detected* Assume state 4 and If the 
Character Is a. letter*, scan the strino for the 
first non-al phanumer ie character* counting the 
number of leading letters end setting s flag If di- 
gits eeeur between letters* If the new character 
is not *!' go to steo 5 to chaek the. ecceetebi 1 1 tv 
of Filename at this tlma* Otherwise set state 2* 
provided that up to three letters oerhaes followed 
only by digits have been seen* Again go to stae 5 
for similar ehack for Deviea. 
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4, If the first chic»eter not '#• in step 3 is •*•» 
accept It in_lieu of Filename* at long as ft Is not 
preceded or followed bv letters or digits* Reset 
the state and aeti 9 n accordingly if ona of the fol- 
lowing characters is detected, Go to atao 9 on 
completion for the relevant eheek, 

a. *,* (state 6) • move past letters and digits 
(or a eingl a •*' ) . 

b. * t * (atata 81 - scan beyond the only valid ee- 
ouanja ' f(diaita) * (digi ts)1 ' (or '*' in lieu of 
(digits) in either ease)* 


e, '/' (atata 1R) • ignore letters or digits fol- 
lowed bv repetitive seouenees of 'i (letters* 
digits* ' • ' or »*»)'. 

d. '<' (state 12) - accept this character only if 
net previously seen end reset 'Current Inout 
Address' in CMDBUF. 

a. CR - ionore as lone as it la followed by e ter- 
minator 

f. LF, FF* VT • accept 

a. All others (including digits) • reject 

9. Xn the relevant atatg table check that the state 
lust terminated ean follow the one previously seen* 
Remember the new state and if not 14, return to 
step. 3* Otherwise take a normal System Exit (see 
section 2*3*4) with 0 on too of the stack, 

6* For i nvel i d characters or states* reolaee the fl on 
the stack with the latest value of the pointer used 
to access the string before taking the System Exit, 

Comments i 

CSX is fullv reentrant at all times and ean be used freely 
whe$hfr, resident or not* It may also, be recalled to 
re-initial isa the workspace for the string if required. 


9,4.2 Specification Decoder (CSH) 


The purpose of the Decoder routine is to set up the 
Link-block and File-bloek for a dataset and transfer direc- 


l 



D08S.HNH 


PAGF^'25 


tion ipteifUd by the prooram# by extracting the next spec- 
ification from the relevant aide of a command strina already 
cheeked bv the Syntax Analyser discussed ln_ the previous 
•ectlon end by then translating its content into the format 
reauired, The program een thereafter perform Its I/O opera- 
tion* upon thst deteset In the normal way described In 
ehoeter* 314, as Qualified bv the reaulrements of any 
switches entered with the sped fleet ion. The program it- 
self# however is responsible for determining the validity of 
those switches for its purpose. 


Cel 1 1 ng Seauencel 

The Decoder expects tha workeeaee C M D8UF associated with the 
line .buffer contflning the strlno to be already initialised 
correctly end performs no syntax ehecks, A call to the Syn- 
tax Analyser must therefore oreeede the ealls to the de- 
coder, If the Analvier Is reeelled# the workspace is reini- 
tialise^ and decoding can thus be started afresh if reauired 
(effeetlno both sides however). 

As noted in the previous section# the first word of CHD9UF 
Is reserved for the program to Indieetewhich specification 
Is to be uepd next. The program sets this word to 0 to sig- 
nify the Input side of the string! 2 the output side. The 
aoproeri ate. Llnk-bleek end Flle-bloek must also be eorrectlv 
establifhed. The format of the latter Is exactly as des- 
cribed In section 4,3,2, The Link-block# on the other hand# 
must include spaee for the device name as shown in section 
3, J, 2,1 and may be further extended to allow a buffer in 
whleh . the Decoder can return Switch information. The pro- 
gram therefore allows sufficient room for all the informa- 
tion expeeted and indicates the size in the Link-block bvte 
showing. "dumber of words to follow". Finally# the decoder 
needs the three relevant addresses. These are sueplled bv 
the prooram In e table as shown at fiaure 5-1* and the ad- 
dress of this table is passed as the only argument In the 
calling aeouenee# e.g. 


MOV SCSIBLK#-(S«») fPASS TAPLE ADDRESS 

EMT 57 iCALL CSM 


Exit State! 

When the Program is repelled# the device name and unit 
number from the specification or from the default stored In 
CMDBUF are set Into the Link-block, unless no specification 
at all was entered for the dataset. In this ease# the dev- 
ice name in the L.ink-block la set to P, Data for the 
Flle-bloek Is correctly stored ior is replaced by 0 In the 
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elements net supplied, entries «r« indicated by oetal 
52 in Filename or Extension. or hy. octal 377 In eithen byte 
of the UIC,. Switeh data 4a listed in the Link-block extern- 
al on as. depicted at figure 5-11, In addition* a atatus coda 
4a returned on the stack to notify the program aa follows 
(bital)* 

Rjt No more specifications to come .on this aide 

Pit li Too mgeh switch data for the soaee allowed 

It is the preoram’e reaoonaibi 1 4 tv to cheek thia (and dear 
it from the staek) and aet accordingly. Internally the re- 
levant entries in the.CNDBUF - current addreaa and# if any 
entered* current device and unit • are undated in reedlneaa 
for the next call for decoding on the same side. 


Processing! 

The processing operations to accomplish the Decoder function 
are illustrated at figure 5-12 and baaieallv follow the out- 
1 1 ne oi ven bel owi 

1, Collect the eal 1 ^parameter and uee it to clear dev- 
ice name and unit in the Link-bloek, the File-name 
block and if Switch apace la provided# a awitch 
step in ita first word. Alee collect the relevant 
String pginter.from CMDBUF for the aide reoueated • 
if 0# exit as for *<• or CR below, 

2, Cheek the next string byte and action accordingly 
as follows! 

a, • oo to exit at atep 7 with o flag to show 
more to eome. 

b, •«' or CP - oo to exit at atep 7 with 1 flag to 
ahow no more. 

e, • oaek.in radix-52 uo to the first throe 

alphanumeric eharaetere and store as Extension 
in the pile-block, Diaeard all auhaeouent al- 
ohanumeriea, Recast the check, (If •*•# store 
octal 52 Instead), 

d, '[• • convert oetal ASCII dioita uo to the di- 
viding •#' end then those following into two 
binary bvtes and store 1" the UIC slot in the 
File-bloek, Repeat the check, 

e. Letter • seen for the first non-alohenumerie. 
It this is ' l 1 # pack leading letters into 
radix-50 and convert the digits# If any# from 
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oetal ASCII Into a binary byte, Store both In 
the LJnk-Mqek as Device name „ and unit. 
Otherwise perform alnole-ereelslen radix-50 
oaekino of uci to the first si* alphanumeric 
characters and store as Filename In the 
Flle-bleek. lanore further aubseouent alphsnu- 
merles. Repeat the eheek, 

f. Dlolt • treat as start of File-name as shown In 
(e) above. 

a. • store octal 52 In Filename and repeat the 

eheek. 


3. If at the eheek In step 2, none of the listed char- 
severs la seen, the next element can only be e 
Switch, so store ud to the first two eharaetera 
followlna as bytes on top of the stack and discard 
all subsequent alohanumeries. 

A, If the next byte Is 'l*. stack the address of the 
one following It* Discard all subseauant alphsnu* 
merles. 'S' or 'a 1 . Repeat this step for any 
further values Included In the Switch, eountlno the 
number of addresses stacked. 

5. Otherwise eheek if sufficient room exists in, the 
Uink-bloek Switeh area for the new data. If so. 
move the Items, stacked during steps 3 A 4 Into the 
Linkfbloek preceded by a count of the words moved 
and followed bv & (If still room) as a switch-stop. 
Reoeat from step 2. 

6. If the Link-block area eennot take the whole of the 
date for the particular switch, remove sueh data 
from the.staek and set a switch overflow Indicator, 
Reoeat from step 2 to move to the specification 
end, 

7. Store the marker results from step 2 (a l d) and 
step 6 on the staek for return to the user. Save 
the strlnq pointer, now showing the start of the 
next specification, in the relevant "Current Ad- 
dress" slot in C dDBUF, If any elements have been 
processed at all, save any new default device name 
and unit In CMDBUFf otherwise move the present de- 
fault values Into the Link-block, Take a normal 
System Exit. 
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Comments! 

Like Its eounteroart In the C3I# this module is futlv 
re*entrant end Its residence 4 s without restriction, It 
should be noted of eourse that C3M contains Its own routines 
for rad1x«50 peeking and octal ASCII to binary conversion 
routings! It egnnot expect to be able to use the Conversion 
Utilities described In seetion 5,3 since these »«v else need 
the Swao Buffer. 


5.5 Program Exit 


(XIT) 


i - e • 

The Monitor offers two methods by which e program can be un- 
leaded from memory when It hee served its pureeset 

a. The console keyboard KILL command 

b. The program service reouest .EXIT (E*T 6«) 

Both methods in fact effectively result In a eall to the 
same Monitor module discussed In this seetion. Its purpose 
is merely to get as a loader for a transient Monitor section 
which oeeuoles memory whenever there is no loaded user pro- 
gram - flreadv mentioned In seetion 5.1 and to be described 
In detail in seetion 6.5. 


Celling Sequence! 

The calling seauenee for the XIT module requires no Parame- 
ters! the E M T 65 Instruction elene suffices. 


General Description! 

Using Its own Internal DD8 and en area of oner-only code In 
Itself as a buffer# the routine reeds the first two entries 
from the directory of .the Monitor Library on the 
system-, device. As shown in section 8.2# the first entry re- 
lates. to the Permanently resident Monitor Itself end Is used 
for re-loedlno. The.aeeond entrv records the svstem-dev 1 ee 
location of the transient Monitor section. The form of the 
entrv was shown earlier In flour® l*** 

The XIT module resets Its Internal pOB from the data in this 
entry in order to read In the transient section. The memory 
area this uses is relgeateble to the upper end of evallabe 
cere ft shewn bv C8A In the SVT (see seetion 2,1,1) provided 
that It Is eorrectlv linked to a top of 17408 (see seetion 
8.1). XIT assumes this end computes both the load point and 
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later the start point on this basis. 

Bafora reoueatlng the read, however# the routine waits for 
any current I/O to, complete since there is no restriction 
that the user must close and release all datasets before the 
.X1T« The, wait la accomplished bv a repeated search along 
the DOB chain from ita origin at OCO In the SVT (see section 
3. 1.2. 3) until no busy states are seen. The read la then 
called. Anv failure in this or In the earlier library di- 
rectory read results In the ultimate error - the Svatem 
Halt. 


Exit State* 

On satisfactory completion. XIT repositions the ataek Imme- 
diately below the loaded transient Monitor section and 

transfers eentrol to this aeetlon with the Swap Buffer re» 

leased for Its use. The transient section is than responsi- 
ble for eleenino-up after the proaram. in particular ensur- 
ing th$t anv datasets still ooen are eorreetlv closed with 

all buffers released and that the normal Monitor states are 

restored* To assist In these operations. XIT transmits the 
following valid register contents* 

R0 a Address of processor Status Register (or *2) 

R5 a Address of DCO In the SVT (see Section 2.1.1) 


Process! no* 

The fpreaoing discussion olves sufficient outline of the op- 
erations performed bv XIT. Flaure 5-13 shows these In more 
detei 1 . 


Comments * 

By its nature* this module need not be re-entrant. It Is 
not. of eounse. because of. the use of i eternal . workspace. 
In thforv. it can be made resident, though since it is used 
relatively aeldomlv, there seems little point In its being 
made so. 
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CHAPTER 6 

KEYBOARD SERVICES 


As its seeono major function, the DOS Monitor* exists to en- 
able the user to control the operations of the svatem 
throuoh the console keyboard. Thus Chanter 3 of the Pro- 
crammers Handbook describes various commands whleh can be 
entered. whenever the M on1tor is In a listenlne state, be- 
cause_e1ther no oroaram Is under execution or such state has 
been foreed by a orlor entrv of CTRL/C, The commands permit 
the loading, starting, stopping and unloading of oroqrems, 
the allocation of resources end the exehanoe of information 
between the operator and the system. The object of this 
chapter Is to Illustrate the Processes by which these com- 
mands become effective. 

Section 6.1 reviews the general philosophy of the Command 
Lanouaae and Section 6,2 describes the organization of the 
modules which go to form it. It will be shown that most 
commands pass Initially throuoh a cordon Interpreter which 
Is made uo of three modules discussed in Section 6,3} these 
commands are then Individually processed bv routines consi- 
dered In some detail In Section 6.4. Section 6,6 covers the 
remaining commends which are handled bv a special transient 
Monitor section which occupies core whenever no program 4s 
aetual 1 v 1 eadeo. 

The external operator Interface Is alreadv fully, explained 
In the. Handbook. In this chapter therefore, this Informa- 
tion appears again only. to the extent that it is necessary 
for the understanding of the internal workings. In particu- 
lar th§ conventions for commend formats are listed at the 
start of Chapter 3. They are used here without further 
reference. It Is also assumed that. the reader Is familiar 
with the special significance afforded certain keyboard 
characters within the language. 
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6,1 General Philo sop hy 

The purpose of this section Is to summarize the structure 
end usage of the Keyboard Command Language and to comment 
upon the underlying principles Involved. 

As noted In the 1 nt roduct i on, a command can be Input whe- 
never, the .Monitor Is In a position to accept such Input, 
This Is Indicated to the operator bv the output of one of 
the following characters at the console tvpewnlterf 

1, * ■ this signifies that the Monitor already has 
overall control of the system and reouires ooerater 
Instructions for Its next action. This Implies one 
of the following situations! 

a, No orooram Is currently In memory, 

b, A loaded program has not yet been started, 

c, A runnlno program has been suaeended; either 
because of some operator request or following 
the detection of some error condition which 
meeds operator 1 ntervent Ion, (see Chanter 7) 

2, • this notifies the operator of the .acceptance 
of his entry of CTRL/C as the means of forcing the 
Monitor to listen, even though the system is under 
orooram eont rol , 

The general format for all commands Isi 

COMMAND [Argument Str1no]CR 

where. "COMMAND" Is a single word Identifier of which only 
the first two letters.need be entered and "Argument String", 
If anv, may consist of one or more arguments separated by 
aoaees (or conras) depending upon the nature of the partleu* 
lar command. Apart from the obvious advantage that this 
format Is standard, It was also deemed more advisable than 
one using soeclal CTRL characters for some commands, for the 
f ol lowing reasons : 

a. The unlaue 1 dent i f 1 c«t i on of a command on the 
basis of two letters offers a wider range of 
variations and hence Is *ore llkelv to be mne* 
mon 1 c , 

b. It Is envisaged that devices under development 
as console terminals for PDP-11 mav not all 
have the full CTRL character facility. 
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e, It Is readilv possible to input a single char* 
actar incorrectly with perhaps disastrous re* 
suit* (despite the need to depress the CTRL 
kev# since this can be done mistakenly foe 
SHIFT). 

On the ether hand# of course# the command being lonaer takes 
more t.ime to key In, It Is unrealistic that a running pro* 
grew should be suspended during the whole of this period es 
well as that needed to effeet the desired result*. Therefore 
no commend is examined until the terminal earraige return 
(CP) .Is detected, .Prior to this# the operator ean change 
Ms mind as often es is neeessary or Can correct his mis* 
takes# end in the meantime# any prooram can continue Its 
normal execution. However# once the command has been fully 
entered# no further Input Is aeeeoted until It has been com* 
pletely oreeessed# 

Finally, It is the Intention that any command# which does not 
Itself (molv some restriction upon its usage fsueh as KILL a 
prooram when there is none in cere to be killed)# should as 
far as possible be available to the user at all times re* 
gardlesa of the general . status of tha svstem, This raises 
two problems# the solution to which will be diseussed In the 
next sect Ion* 

1, The Monitor must have access to a driver for the 
eonaole terminal even though the program In eore 
does not expeet I/O from this as a device* 

2, The processing of a command eannot be carried out 
in the normal Swap Buffer when thi* Moht be alrea- 
dy In use by some other Monitor routine servicing a 
runpino orogram request. 

Moreover# upl ess the command i tsal f_ changes the status# any 
running program must continue after Its execution as if 
nothing had happened. 
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6.2 Proan l nt 1 o n 


Before the command orocesaora themselves are examined* the 
overall internal atructure bv whleh they ere controlled re- 
quires explanation, Aa noted In the laat section* the M en1- 
tor must* In effect * be able to aeeept a command at any time 
and the ooe.retlon reaueated muat be carried out tranparentlv 
to the orogram currently occupying memory. Sections 6,2,1 
throueh 6,2.4 show how thia la accomplished under the four 
main headlnoat 

a. Aeceotanee 

b. Decoding 

e, Proeeaalng 

c. Clean-uo 

Section 6.2.5 than dlseusses conventions used throuohout the 
normal Processing of the language. 

Zt should be noted* however* that the processes described In 
this Section do not apply to commands which by their natura 
do not have the problem of a runnino program to consider* 
beeause none can be loaded when they are used* l.e.* RUN* 
GET* and FINISH. These commands are handled by the transi- 
ent Monitor seetlgn and as mentioned in the Introduction are 
described In Section 6.5. 


6.2.1 Common d Accepts rics 

Basically* to the Monitor. expecting a command, the console 
terminal Is an Input, device with a purely subsidiary outeut 
facility as, a means of echoing the eharaetens entered. To a 
running orogram* however* the console terminal jsa device 
with mutually Independent Input and output facilities* but 
with the eeho requirement an added complication. 
Furthtrmone# If the particular console device is the eur- 
rentlv standard A3Ry33 Teletype* there is also the 
paper-tape eauloment which again in Its usage need have no 
relationship to the keyboard/typewr 1 ter. As a result* the 
normal driver. which eaters for the full range of the console 
terminals facilities is necessarily somewhat large and It is 
especially Important that no orogram should pay the penalty 
for Its, presence in core unless It is actually required. In 
other words* this driver should be no different from those 
for other devices which are loaded In response to ,INIT and 
unloaded by ,RLSE ** described In Section 3.2.1. 
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Nevert hel eat# the Monitor must have access to a driven of 
some sort at all times* Respite the programs meeds* Such 
driver ?an be more limited In Its seoPe end need be Inter- 
rupt-driven only. However, slnee anv keyboard Input must 
Initially be considered a ootentlal command, this driver 
must examine every character entered In ease It should hap* 
pen to be the CT^L/C needed to make the Monitor listen. 
Moreoyer, any character output mioht be the eehe of a com- 
mand Inout, The first part of this driver Is therefore a 
module within the permanently resident monitor, as noted In 
the Introduction to. Charter 2. This module intercepts all 
console, terminal interrupts and then connects these aopro- 
prletelv either to the remainder of th* Special Driver or to 
the full driver If this Is in eore et the service of the lo- 
aded Program, That this module need ba resident really geas 
without saving In view of the excessive overhead otherwise 
incurred at each console interrupt. 

On the other hand, the rest of the Monitors driver only 
needs to be In core for the time taken. bv the operator to 
enter e command, Unfprtunatel y, though, it cannot be loeded 
bv the usual method for drivers for th# following reesonsi 

e. The normally non-resident . I N I T is needed end 
this 1s_ not neeesserlly available slnee the 
Swap Buffer might already be oeeucied bv some 
other module servicing a program reeuest, as 
noted at the end of Section 6,1. 

b, The driver Itself would oeeupy a buffer claimed 
from free eore through the Monitor sub-routine 
S.GTB which was shown in Section 2.4,3 to be 
not re-entrant and which also mioht be in use 
on the proorams behalf. 

An alternative method has been adopted therefore! the Moni- 
tor driver is In feet a module celled bv its own fwT (31), 
Hence it is loaded by the normal processes of SAM into the 
subsldlerv Swap buffer reserved for tha keyboard command us- 
age es outlined In Section 2,3,1, 

In order to allow a running prooram to proceed as stipulated 
In Section 6,1, the command Itself must be buffered until It 
Is completely Input and echoed. The neeessary area for this 
cannot be provided within the K3B for, as will be shown in 
the following sections, this is used by the other command 
modules. _ Moreover for the same reason as that given above, 
the use of free core is out of the aueatlon, Henee the com- 
mand Is stored by the driver within the area allocated to 
Its permanently resident interceptor Portion discussed ear- 
lier, The resulting use of memory during commend acceptance 
is illustrated at figure 6-l(a), It should be noted that in 
the interest of keeping the resident buffer area to a mini- 
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mum# it Is not possible to allow more them one command Input 
•t s tins. Henee ss soon ss s comp] ate . commend has been en- 
tered# the keyboard Interrupt facility is disabled until the 
execution of that command has been completely effected. 


6,2.2 C ommen d D ecoding 

Onee the Special Driver has served its purpose of collecting 
the command, an appropriate routine must be celled to ser- 
vice it. This routine must also .use the subsidiary KSB. 
However# In most eases* eaeh of the currently implemented 
command! reouires a measure of Processing for .whleh the 
whole of the 126-word space allocated to the KSB is taken up 
as e minimum. Thus eaeh command needs Its own Individual 
processing module# and whieh module this is must be deter- 
mined from the command code entered. Hence* the driver 
calls en. Interpreter whleh satisfies this function and also 
then Provides for the neeessery eel! to the module reoulred. 

The first of these operations Is relatively aimole to accom- 
plish and naturally includes s cheek on the validity of the 
eode. However# the subseouent call raises a problem. The 
Interpreter itself# for simplicity# ean be and Is allocated 
Its oyn EHT eode and the driver uyes this as Its means of 
transferring control. .However# it Is net feasible that ev- 
ery single command routine should absorb further unioue EHT 
codes* particularly when additional commands may beeome ne- 
cessary as the Monitor is developed further. The solution 
is the use of the soeelal entry into SAM described In Sec- 
tion 2,3,2, This was shown to allow the calling of several 
modules bv a single code through the following seoueneet 

1, Set R0 to shew the svstem-devlce, address and size 
of the Individual module In HRT format (see Section 
2 . 1 . 2 ). 

2, Cell EMT 30 (for KSB usaoe). 

This means# of course# that the Interpreter must be. able to 
supolv the necessary Information for Rd on the basis of the 
command eode. For this purpose* a dlreetlv accessible index 
to the locations of the modules within the system Library 
must be available* for a complete search of the whole Libra- 
ry at eaeh command Is out of the ouestlon. However# the es- 
tablishment of sueh index Is a further problem# when in the 
norma] way# Monitor modules can be stored anywhere within 
the Library and In addition the varying block sizes of the 
potential system-dev i ees noted In Section 4,? must be taken 
Into aeeount, Moreover# as Implied above# several of the 
command Processors themselves hove the seme problem because 
thev need to overlay themselves In order to accomplish their 


D086.RND 


PAGE ie 7 


function, Currently# therefore# the index and the corres- 
pond! ng.medul e storage on the system device Is prepared as 
p«Pt of the assembly and linking of the Interpreter and the 
•uPPOPtlno command modules as follows! 

1. Each module is conditionally assembled with a see- 
ondepy oaPamatap input which is based uoen the in* 
tended svatem-devlee (see Section 8.1,1), 

2, All the modules ape 1 1 nked toget her Into one load 
module in a sequence fixed bv that of the Index, 
This then provides the coppaet detail of the rela- 
tive position of aaeh command ppoeessop within the 
complete bloek (sea Section 8,1,2), 

The Index itself can potentially be toe laroe for inclusion 
within the Intepppetep module. To ovepeeme this* the index 
can be eeamented scposs several devlee blocks Immediately 
following the Intepppetep In the llbpapv. The oenepal oper- 
ations eappied out by the Intepppetep eon bf summarized as 
follows (sea Section 6,3,3 fop further detail)! 

1, Cheek whetheP the reoueated commend is one whieh Is 
grocesaad by an embedded routine • because a falPlv 
immediate response Is needed (i.e, COwTINUE# WAIT# 
STOP), If so oo to it, 

2, Otherwise use the area occupied by these embedded 
routines as a buffer into which the appropriate 
block of the Index can be read# then from the entry 
coppeaoondi no to the reoulred command# set end 
cell the relevant routine by E M T 3*1, 

The offset of these operations on KSB uaaoe is illustrated 
at Flours 6-l(b). 


6,2,3 Command Process ing 

It was shown in the previous section that# apart from the 
three commands having routines embedded within the Inter- 
preter and those especially handled bv the t-ensient Moni- 
tor* all other commands have correspond) no unioue modules. 
It is their resoonsibi 1 i tv firstly to verify end oreeess the 
argument string within the commend and then to carry out the 
operators requirements end provide the eporopriete return to 
the running program If need be. 

In oeneral# the arguments are entered in some format under- 
standable to. the operator. This means that conversion Into 
machine. code is necessary in all eases, Onee again, the 
proeesslno routine must presume that the normal Swop Buffer 
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is not available for aceess into the M 0 ni*or Utility Facili- 
ties described in Chapter 5 unless this is soeeifieallv al- 
lowed bv the system-state at which the command can be given, 
Henee. most routines contain their own embedded conversion 
funet ions. 

The amount of proeassino needed to execute the command obvi- 
ously determines the form of eaeh module. In seme cases* 
the whole operation ean be completed within e single KSB 
frame* .in others however this is impossible. As a result* 
overlay, ina is neeessery end the processing is naturally or- 
dered to allow a simple sequencing of the overlays* as shown 
in Hours 6-l(c)» rather than partial substitution. Henee 
eaeh .overlay ean be ealled by the same special SA M entry 
technique used to fetch. the module initially, Tn eaeh ease* 
the svstem-deviee location of the next overlay is determined 
on the assumption that the complete set occupies numerically 
continuous .bloeks as provided. bv the aaaembl y/1 i nkage ore- 
eass noted in the previous section. 


6.2 .4 Comm and^ teen-up _ 

The form of the exit taken by the eommsnd processor depends 
uoon the command itself. Some commands* of eourse* imolv 
that any orogram possibly running when the operator inter- 
vened is not to be recalled in the normal way* e.g, BEGIN* 
RESTART* KILL* 00T, In their case* the processors are res- 
ponsible for establishing the correct, machine-state before 
they leave. In particular* the proeessor-stack and Regis- 
ters must be eorrectlv set for the operations to follow. 

In all other eases* however* the original state must be re- 
stored, Moreover* for any command entered there is always 
the possibility that* due to some error in syntax* time of 
entry or argument invalidity* the operators reouest must be 
rejected. To provide a eommon return to normal* the Special 
Driver module outlined in Section 6,2,1 is recalled to the 
KSB with appropriate switches set* as shown in the next sec- 
tion, This is than responsible for Printing any error mes- 
sages reauired and* if neeessary* the S needed to show that 
the avstem continues in a Monitor listening state. 

The driver module performs the terminal printing on inter- 
rupt, Tn the meantime it exits throuoh its resident section 
end in the process the staek end Reaisters ere reset to 
their state prior to entry into the command processing oper- 
ations. After the printing has been completed* the resident 
Listener carries out the final elean-uo of its own internal 
switches. It then restores the keyboard for acceptance of a 
new command and the typewriter to anv orognam output inter- 
rupted. 
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THIs Procedure also leaves the Special Driver module in the 
K3B as shown in Flqure 6»t(d), In General# therefore# It is 
Immediately available for the entry of a naw command without 
further svstem-dtvlee access. 


6,2 . 5 Command _C o nvent Ions 

The general proeesslnq scheme outlined in the Previous sec* 
tlons obviously means that certain conventions sra eats* 
bllshed.to eenmlt.the standard interface needed. These are 
summarised for reference In the following paragraphs* 


6,2,5, 1 Calling Parameters 

In order to pass data, between the various modules# the fte* 
gisters are used and it. Is the responsibl 1 Ity.of this eelllna 
module to set them accordingly Cthe receiving module of 
course collects their content.from the stack as saved bv the 
normal FMT Process described in Section 2,2,1), Zn partleu* 
lar# the common Interfaces to and from the Individual eom» 
mend eroeessors are as follows* 

1, Entry from the Interpreter* 

91 s Address of the last bvte (I.e.CR) In the 

command Input 

92 a Command code (1 character per bvte) 

93 • Address of the Start of the SVT 

94 b Address of the typewriter hardware buffer 

95 b Address of the start of the eommsnd argument 

string (or if none ■ Rl) 

2, Exit via the Soeelal Driver* 

Rl b Error flag (a negative eode Identifies an 

error detected - positive (snv value) If no err 
or) 

94 b Address of the typewriter herdwere buffer 

95 b 0 to Indicate processing completed 

The remaining interfaces are detailed within the appropriate 
module descriptions In the following sections. 


6 ,2. 5. 2 Processor Stack 

Although the stack is not used to transmit date, seeh module 
must ensure that the correct state Is passed to its sueees* 
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•or. I* general# this means that the contents of Registers 
•aved at eaeh internal EMT eell must be removed. In addi- 
tion# the only return taken in the normal wav is that to re- 
call the resident Listener on completion. Hence the return 
PC and status saved bv the EMT must also be cleared in all 
other eases (see Fioure 6-2) 


6.2.5.3 C • 1.L_t®c hjiloufti . 

Sinee, eaeh module eePs the next stage by means of an EMT, 
the normal SAM reouirements described in Section 2,3 must be 
observed. In other words# the celling routine must ensure 
that the, Swap Buffer it Is currently oceuoyino is released 
for the following user by dee rement at 1 on of its Useee Count, 
Again# ..there, arises the problem of doing this from within 
the buffer while the routine is still present. Other Moni- 
tor modules# it was shown In Section 2.3.4# solve the prob- 
lem bv eelljno a common Svstem Fxit In the resident Monitor, 
However this seouenee is of no use to the commend language 
modules# since they do not restore Registers or return. 
Instead therefore a sceda! outlet Is provided Immediately 
following the KS9 which they can access by "drooping 
through". 

The first instruction in this seouence performs the necessa- 
ry reduction in the Usage Count byte. The second is set by 
the routine to cause the reouisite next action. Thus in the 
general ease following! 

DECB KSB f FREE SWAP BUFFFR 

XXX 

XXX is reolaeed bv one of the following! 

a. EMT 33 for the call from Soeelal Driver to In- 
terpreter 

b, EMT 3a between interoeter and Individual pro- 
cessor module (or between overlays of that mo- 
dule) 

e, EMT 31 for the Special Driver recall from a 
processor module 

d, RTI ss the. means of exit from the driver to Its 
resident Listener, 

It was shewn in Sections 6.2,3 and 6.2 f 4 that# because R0 
must be correctly set when the call Is EMT 30, the modules 
and the Interpreter index are set uo ®t essembl y/1 ink time 
to provide a fixed relative system-device location. This 
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meant that the absolute petition of the module currently In 
the K3P must also be known. This Is readily available from 
either of th« following sources! 

a. 00 on entry (as stored on the staek by the EMT 
handler) - If also called by EMT 3<* 

b. The oeeuoant*! dent 1 f ler word In front of the 
KS? as set by SA M (see Seetlon 2.1.3) 

(The relative increment# of course* must allow 
for MRT format# l.e, 2*Relatlve Bloek e) 


6. 2, 5. 4 Reent re ncy 

It has been shown# in feet# that the keyboard language Is 
executed bv an overlayina scheme. This In Itself eutometl* 
eellv removes any oossiblllty of rerentranev from each of 
the modules eoneerned. No definite attempt has therefore 
been made to ensure that the modules do net break the rules 
In this respeet (though In most eases# natural usaea of the 
staek rather than of ordinary in-eore locations tends to 
prevent this). In particular# the eall teehnloue described 
In the previous section Is a deliberate violation. 

Due to the leek of reentranev capability# two features have 
been implemented end should be noted! 

e. Anv interrupt from the console reeells the See* 
elel Driver module. Although In reality# such 
interrupt should never hapoen# since both Input 
end outeut sides ere disabled while a command 
is processed# for absolute safety the priority 
level Is .maintained at 4 as set by the Inter* 
ruot eall initiating the execution phase. This 
also has the advantage thet.the command eoera* 
tlons are completed as ouleklv as possible 
without stoppage to service the less erltleel 
devices uslno this priority level* without pre* 
ventlno the more Important Interrupts at higher 
level s(l). 


1# There can be problems# however# If errors occur in the 
devices using the higher levels - see Charter 7. 
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b. Because the tyewrlter interrupt facility cannot 
thua be used to control the printino of Infor- 
nation requested bv the operator* the oroees- 
tors of commands for this ourpose contain their 
own routines to access the hardware reolsters 
dlreetly and wait between characters. 

6. 2. 5. 5 B*I 1 dency 

Elsewhere In this manual It has been shown that without true 
reentrencv* the residency of anv module unprotected bv SAM 
can also be dubious In certain situations. To seme extent* 
this applies also In the ease of the keyboard language mo* 
dules* However two more important aspects must be eonsl* 
deredt 

1, The use of the soeclal entry to SAM by PMT 30 as 
the „ means of access to th« Indivdual processors 
Intrlnsleel 1y presupposes that these win always be 
brought from the system-device when, required. 
Moreover# the very reason for this practice ■ the 
avbldenca of excessive allocation of FMT eodes and 
henee of a lonoer MRT to eover. them • means that 
the sole link to their location Is throych the In- 
terpreter Index based on svstem*dev1 e« library data 
only. 

2. As well as preventing re*entranev# the call teehni- 
oua described in Section 6.2.5. 3 also imolies 
non*res1denev slnee it ean only work If the routine 
using It Is within the KSB. As shown# this applies 
to all the language components net Just the indivi- 
dual processors. 

All In all* therefore the reaideney of anv eart of the key- 
board command structure Is out of the question end on this 
besis no other provisions for sueh e Possibility have been 
made.. In , part 1 eul ar# none of the routines attempts to eheek 
Its location In the aame way that the other Monitor modules 
do# uelno the Procedure described In Section 2.3,5. This 
meens of eeurse a departure_f rom overall Monitor philosophy. 
However it. Is currently felt that strict adherence to the 
principle does not warrant the extra code# probably resi- 
dent# t* 1 *.** u° to Implement it in every system - an espe- 
cially Important consideration for the user with the smaller 
eonf 1 ourat i on • Furthermore# even for e user with core to 
soare# It. Is expected that the keyboard operations will be 
very low in his list of prlorltes for modules to be made re- 
sident# firstly because of the predictably low relative fre- 
quency of usaoe and secondly because# eyen with 
svstem-dev lee accesses* the response time for any command is 
not unreasonable in most eases - at least bv comparison with 
tha Inherently slow nature of the console terminal device. 



DOSb.RND 


page fc-13 


6*_3 Cowmen Command Proeassino 

Tha object of this section Is to discuss in detail the key- 
board. language wodu 1 es^whieh provide for common acceptance* 
deeedino* end elean-uo for all commands* Section 6.2 indi- 
cated that three modules are in faet involved! 

a. A permanently resident routine which monitors 
all console terminal Interrupts and calls a 
special Special Driver wh*n e eommend is under- 
way • see section 6.3,1 

b, A non-resident driver whieh accepts* buffers* 
and echoes a_eommand, input and later provides a 
common exit for terminal printino on completion 
or error - see Section 6.3*2 

e. An Interpreter whieh dispatches to the appro- 
priate routine to process the command on the 
basis of its twb-lattar code - see Section 
6*3.3* 


6*3.1 Console Keyboard Listener (RM0M5) 

In Section 6,2,1 it was shown that the permanently resident 
Monitor must contain a routine eaoable of intercepting all 
eonsol a, terminal i nt er rupt a . s i nee any one of these* whether 
inout or outout* is potentially appropriate to the entry of 
a keyboard command. It is then the resoonsibi 1 i tv of this 
routine to transmit eaeh interrupt tp the correct driver* 
whether this be the one especially provided to handle com- 
mand . 1 nput . deser 1 bed in the next Section or the full driver 
if this is in core on a programs behalf. This routine also 
includes the storage soaee in which a command is buffered 
and eehoad. 


Call Seaueneel 

The routine. is called bv direct connection through the eon- 
sole terminal interrupt vectors (standardly locations 
60-661.. As shown in Section 2,1,4, these are set as oart of 
the initialization seauenee when the permanent Monitor is 
first booted into memory, A single entry for both inout end 
output is used to enable a common sequence for the saving of 
the interrupted oroorams Registers and the setting of po- 
inters. The processor Status Reoister however is given a 
different C-bit on the interrupt as the means of determining 
its source when unioue operations must be performed* i,e, 0 
s input and 1 ■ outout. 
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General Description* 

Basically both forms of Interrupt lead to • cheek on whether 
or not, command oroeeaaing Is required. If it iii the Sea- 
eial Driver is celled Into the KS« as indicated in Section 
6.2.2. If the driver then returns control# either wore in- 
put is exoeeted or a command allowing normal program resump- 
tion has been executed. In both esses# the latest state of 
pointers « assumed eorreetlv set - is saved end the inter- 
rupted prooram is recalled. When command processing is not 
underway# the routine verifies the presence in memory of the 
full eonsole driver# using the content of K«A in the 3VT 
(see Section 2.1.1) to aeeess end examine the core-address 
entry for device kb in the DDL (see Seetien 2.1,3), If this 
is non-0 , control is passed to the full driyers interrupt 
service routine to take the aoorooriate action. Otherwise 
the interrupt is ignored and the suspended prooram is re- 
celled. 

The internal buffer space is structured as i 1 1 uat rated at 
Figure 6-3. It provides in effect three main areas as fel- 
lewsl 

t. Pointer Store - used to save pointers between in- 
terrupts and temporary data during processing as 

under* 

a. Command Buffer pointer • shows the next byte 
for input storage when a command is underway. 
At all other times it is cleared to B and thus 
also sets as a switch to show whether or net 
the Monitor is in a listening state# hence the 
Program Loader (see Seetien 5.1) and the Error 
Diagnostic print routine (see Section 7,2) can 
force such state - S type- by marely setting 
the Pointer. (its address is stored at the 
start of RM0N5 to eive these routine aeeess 
through the eonsole interrupt vector) 

b. Echo Buffer inout pointer - indicates the last 
byte of echo stored ready for printing. 

e. Echo Buffer output pointer - is held at the 
last echo eharaeter despatched to the printer. 
This must always trail the input pointer so it 
is initialized one bvte behind. 

d. Hardware Register pointer • is used to access 
the external page registers for the eonsole 
termi nal , 

e. I/O Switch - is set to the C-bit content on en- 
try to the routine (see "Cell" above) 
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f, Inout Byte Store - hold* an incut character for 
checking or is 0 for an output interrupt, (it 
ean therefor* be used a* an alternative T/0 
Switch - see next section) 

2, Commend Suffer • allewina for * full typewriter 
line of 72 characters since the command lanauaq* 
makes provision for "off-line" comment oreeeeded by 
t • see Programmers Handbook, 

3, Eeho Buffer • necessary because there may be more 
then on* character to e single inout, e.«. CTRI./C 
becomes a, c» CR, (IF and , are output soeeifi- 
eellv by the driyer - see next section). It begins 
with a single switch byte, whieh is u»ed to store 
the console printer interrupt statua appertaining 
to a suspended program (or 1) while command input 
is, underway and is 0 otherwise! it ends with a 
stop-byte containing -1, Between the** two bvtes, 
a minimum ar?a i* provided on the basis of the fol- 
lowing principles • (see next Section): 

a. The printer is always considered the slave of 
the keyboard when a command is bei ng. entered# 
anv other operation by the program being sus- 
pended to accomplish this, .Thu? in most eases 
the eeho ean keep oaee with its input, 

b. The buffer pointers are re-initialized as soon 
as the last stored ehareeter has been printed, 

e. For the longer eeho sequences* such as CTRL/C 
and CTRL/U# the keyboard interrupt is temporar- 
ily disabled to Prevent the inout from gettina 
too far ahead. 

For the sake of completeness, the KSB is also included with- 
in the RM0N5 modulf. As noted in Section 2.3,1, this is 
preceded by the word in whieh Sam saves the system-device 
data from the MRT to identify the current occupant • In 
front of this word, two additional data items are stored for 
eesv access by the Special Driver, when this i* in the KSB 
on reeall after command execution! 

a. Dummy buffer • (using the high-order bvte of 
the word containing the Echo Buffer stoo byte) 
allows the driver to store S for continuation 
of a Monitor listening state without the need 
to re-i ni t i al i ze pointers completely, 

b. Echo Buffer start - enables reinitialization of 
pointers when no continuation of listening 
state follows! 
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The K9B,1§ followed bv the three-word exit seouenee dee* 
eMbed In Section 6. 2. 5. 3 


Exit etetei 

As noted in Section 6.2.5. 1* date Is transmitted through Re* 
glsteea. on transfer of control to tha drivers. This is as 
fol 1 owe t 

1. Call to the Special Driver! 

R0 ■ Start address of the Eeho Suffer 
R1 ■ Addresf of next bvte for Input storage 
for 0 i f CTRL/C Just entered) 

R2 ■ Address of the next character to be 
stored In the Echo Buffer 
R3 ■ Address of the last character 
printed from the Eeho Suffer 
R4 a Address of the appropriate hardware 
buffer In the external Page 
R5 a Address of the Input Bvte Store 

2, Call to the full driver* 

R0 a Inout character or 0 If output 
R4 a Address of the appropriate hardware 
control status Register 
(C bit is set as on entry to show 
Interrupt , type* l.e. Bainput 
and 1 "out out ) 

In both eases* the Interrupted programs Register contents 
are saved on too of the ataek, For the Special Driver eall* 
the address to the Pointer Store Is above them end must be 
returned intaet on reeall (see Flaure 6*2) 


Detailed Description* 

The outline of operations performed by RH0N3 follows. 

Figure 6-4 Illustrates the seeuenee In more detail. 

1. Save the entry C*bit In the I/O swlteh byte in the 
Pointer Store (see above) and then the interrupted 
programs Register contents on the stack, Reset the 
Registers from tha values held in the Pointer Store 
and remember the Store address on the stack, 

2, If the I/O swlteh shews the Interrupt was caused bv 
output* go to step S, For Input* read the char- 
acter entered and save a copy of It, stripped of 
bit 7* l.e. parity, in the Input Byte Store for 
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later checking. (ignore pull* within command*) 

3, T**t the Command Buffer Pointer. If It i* non*0# a 
command Inout i* already underway# h*ne* go to step 
7 to c*11 the Special Driver, Otherwise eheek 
whether a switch was set at step 5 because the last 
character Incut was FSC or ALT M 0DE» either of which 
orfvents special treatment for the character Inout 
this time (Including CTRL/C). If so* clear the 
swjteh and go to steo 6 provided that the full 
driver Is In eore (see "General Description" above) 

4, If the Inout character Is not CTPL/C# and the full 
driver is not In eore* collect the Pointer store 
address from the stack and save the appropriate Re* 
olster contents for nest time. Go to the System 
Exit (see Section 2.3.4) to restore the eroqrames 
Reolsters and return# thus lonorlno the entry, 

5, If the full driver Is in core# look for ESC or ALT- 

MODE (l.e. ASCII eodes 33, 179 or 176), Set a 

switch for next time when found (see steo 3) 

6, Detenmlne the entry oolnt for the full drivers In- 
terrupt service routine from the offset In its In- 
terface table (see Section 3,3,1)* reset the C*bit 
from the I/O swlteh byte and oo to It, 

7, If the Input, character Is CTRL/C# set a oointer to 
the start of the Echo Suffer and call the Special 
Driver bv Emt 31, Should a return oeeur# because 
either more input Is expected or the command has 
been executed# recall th* Interrupted program 
through step 4. 

S. For an outout i nt er rupt # elear the Input Byte Store 
as a switch for the Special Driver (see next Sec* 
tlon) and disable the printer Interrupt. If the 
Commend Buffer Pointer is non-0 (command Inout 
underway) or the Eehe Buffer cutout pointer Is not 
at the buffer start (elean>up print still Ineom* 
olete)# do to step 7 to eall the driver, 

9, Otherwise examine the flrat byte of the Echo Buffer 
(see above). If it Is a *# the Interrupt can ornlv 
be prooram- 1 n 1 1 1 at ed# hence a© to step 3 to eall 
the full driver provided that it Is in eore, A 
non*B content# however# indicates that a command 
has been finally eomoleted. Use sueh content to 
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reset the console printer interrupt status to its 
state prior to. the eem-and entry and clear the bvte 
(1), Exit through step 4, 


6.3.2 The Special Con sole Driver (KBl) 

The purpose of the special command driver# as already indi- 
cated in Sections 6.2.1 and 6,2,4, is twofold! 

1. It processes all console terminal interrupts aria- 
ino durino the inout of a command# aa passed on by 
the Listener discussed in the previous section# un- 
til a complete commend has been stored in the 
buffer within the Listener. It then calls the In- 
terpreter described in the next section to Process 
the command as required. 

2. It provides a common exit sequence for all command 
processing modules returning control normally to 
the program interrupted by the command# taking care 
of any error conditions detected. 


Call Seoueneei 

For reasons given in Section 6.2,1# the Special Driver is 
called by its own E*T thus! 

E*T 31 jCALL KBL 

ho arauments are passed. on the staek} however it does expect 
the stack-top to. contain Register contents saved by the EMT 
Handler (see Section 2,2,1)# as listed either in the previ- 
ous seetjon when ealled by the Listener durinq the input 
phase or in Section 6.2,5. 1 for the eommon exit recall. 


General Description! 

The content of the saved R5 on entry is nen-0 for the Lis- 
tener call. In this ease# the driver is responsible for 
storing each valid inout character in the Commend Buffer 
within the Listener and for orodueino the appropriate echo. 


1. If this reenables the printer interrupt# the Listener is 
immediately recalled after exit. By the eheek in step 9# 
the new interrupt is then passed on to the full driver# thus 
allowing program output suspended bv the entry of the com- 
mand to proceed. 
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Etch character of Input or output Is handled at one Inter* 
rup$ and the pointers passed In the Registers ere used for 
buffer aeeeas, The driver must also provide the seeelal 
treatment afforded to eertaln characters detailed In the 
Programmers Handbook, When It reeeonltes that the echo for 
the CP terminating an Input line has been output# the driver 
removes any eomment content proceeded bv t and if any data 
remain*# it ealla the Interpreter, otherwise it exits to 
the suspended program# perhaps with! output If a Monitor 
listening state Is to be maintained. The return In thl* 
ease and from the Intermediate interrupts during Input ae» 
ceptanee is bv wev of the Listener, 

The common exit operation follows detection of •* In RP on 
entry. If Rt Is negative# the Interpreter or an Individual 
commend processor has uncovered an error in the incut com- 
mand, In this ease# an overlay la called and this converts 
the Implied error code in R1 into a plain language error 
message at the printer end the eo-mend is rejected, (such 
error* must be handled in this wev beeeuse the normal niag* 
noatle Print routine also uses the KSB (see Chaoter 7 ) and 
this of eourae Is. still oeeuped bv the driver). For eosl* 
tjve Rl# Indicating command processing has been satlsfaeto* 
rilv completed • or after recall when the error message has 
been output# the driver cleans up end again returns to the 
Listener to exit to the Interrupted program. 


Exit Stetet 

The Register contents passed on by the driver are as 
fol lows! 

1, Interpreter call! 

Rl ■ Address of the bvte containing the 
terminating CR 

R4 « Address of the console printer 
hardware buffer 

R5 ■ Address of the first bvte of the command 


2, Listener recall! 

Rl » Address of the next byte to be 

filled In the commend buffer (or 0 if no 
further input la expected) 

R2 ■ Address of next byte to be filled In 
the Eeho Buffer 

R3 ■ Address of the le*t bvte Printed 

from the Echo Puffer (or Initialised 
as noted earlier one bvte behind R2), 
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On the Interpreter call# the stack 1 s pasted with the L1a» 
tener. recall Parameters, on top# ready for eventual exit when 
the command has bean processed. The Listener Is recalled 
with the stack set as on entrv from It, (This reouires some 
elearanee when the driver Is used In Its common exit role) 

Detailed Processing! 

Figure 6*5 illustrates the Processing procedure of the See* 
c 1 a 1 Driver! an outline of the steps taken follows! 

1, Restore Register contents passed bv the celling 
routine, 0 In R5 Identifies a call for the common 
exit operation of the driver! if found go to step 
12, Otherwise examine the Listeners Input Bvte 
Store through P5. When this again Is 0* a printer 
Interrupt has ioeeurred# henee go to step 9, 

2, Test the Input bvte for CTRL/C or CTRL/U, In e 1 • 
ther ease* move a Into the Eeho Buffer followed by 
the cor resoendi ng letter and reset the incut bvte 
store to CR, Set the Command Buffer pointer for a 
new command inout - and thus also the underway 
switch. Save the current printer interrupt Status# 
forced non-0 bv bit 0 » 1# In the first byte of the 
Echo Buffer (unless this Is already other than 0# 
Indicating a fresh attempt at the command string). 
Disable the keyboard interrupt to allow the echo 
print to keep in pees and go to step 7 for exit as 
reoul red. 

3, If. the Input bvte is RUBOUT# eheek the next Commend 
Buffer byte for 0, signifying that this Is the 
first entered (see below). In this ease move 6 into 
the Echo Buffer(l). 


1, The, cheek uses an algorithm based on the fact that if 
any 7»bit ASCII character Is incremented# RLIBOUT Is the only 
one whleh becomes negative# 1. a,# 200 (a value with no coal- 
tive complement). At Indicated in the text# the next byte 
In the Commend Buffer is set to 0# unless RUBOUT Is seen 
when 200 is stored, Wanes a negative eomperlsom between the 
new Input end this bvte signifies 0 print# as shown by the 
following table! 


INPUT BYTE 

NO P/0 <230 

FIRST R/0 200 

successive R/0 200 

FOLL. NON-R/O <200 


BUFFFR BYTF PFSULT 
0 < 200(0 

0 200(0 

200 0(0 

200 > 200(0 
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Move the lust character from the Command Buffer In 
the Echo Buffer# if any remain (1)# and replace It 
by 2&0 aa a flag that a RUBOUt seauence It under* 
wav. Go to step 8 to exit, 

4, For anv other inout# also perform the eheek en the 
next buffer byte and If negative aa sat by step 3 
at the last input# move a terminatlno a into the 
Eeho Buffer (hanee producing required print ae- 
auencei a (delated characters) a) 

5, Cheek for CR. When detected# storey In the Command 
Buffer as a stoo and then scan the buffer from the 
beginning for the first occurrence of » as the pos* 
slble start of comment. Replace this with the CP 
entered to remove the comment. If no valid Input 
remains after this# because either the whole line 
was comment or there was no line at all# dear the 
Command Buffer pointer and hanea the underway 
state. Again disable keyboard Interrupts to avoid 
Echo. Buffer overflow (and prevent a new command In* 
out if one Is now In), Go to step 7. 

6, Ignore any other 1nput_ if no more spaee exists 
within the Commend Buffer, Otherwise store the new 
character , 

7, Clear the next buffer byte as the "No RUBOUT" indi* 
eater and move the incut byte Into the Eeho Buffer 
(or Its replacement - see step 2) 

* B. Should no further room remain in the Eeho Buffer# 
step keyboard Interrupts to allow the print ooera* 
tien to catch up. If then the printer Is currently 
busy # recall the Listener to return to the Inter* 
ruoted program, (the new eeho. will be handled sub* 
aeouentlv to the next printer interrupt) (2) 


1# Because. the Input Byte Store Immediately^ precedes the 
Command Buffer * see Figure 6-3# It fellows from the previ- 
ous note that If an attemot to collect the last character 
entered shows a negative value# It is In fact the new RUBOUT 
In the store. Hence no further deletions ean be made on 
this basis. 


2# If the command is Just beina started# the printer is 
working on. the oroorams behalf In this ease, Slnee the 
underwav switch Is now set# the Listener will pass the in* 
terruot excepted by the full driver Into this routine, 
Henee.the eeho*opint will then be Initiated and prooram out* 
put will be suspended until the command has been executed. 
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9, When the lest eharaeter dispatched from the Echo 
Puffer Is not CR# eheck whether further eeho print- 
ing Is needed (malnlv fo* dlreet entry from step 
1), If so# send the next ehareeter.to the printer 
with Its Interrupt enabled. Otherwise reset the 
Echo Buffer pointers and if neeestarv referable 
keyboard but net printer Interrupts (see step 9), 
In either ease# return to the Interrupted program 
via the Listener to await a fresh eall, 

19, Follow a CP print with the deseeteh of IF to the 
eonsole. If a valid eommand line now exists# eall 
the Interpreter to proeess 1t,(t) For a eommand 
Just started or restarted by CTRL/'* or a second 
CTRL/C store , In the Eeho Buffer# overwriting the 
stored CR to ensure Its belnp within the evsllable 
space. Exit through steo 9 with the Printer Inter* 
ruot enabled* however# wait for next tine to reen* 
able the keyboard. 


1, It should be noted that the LP Print is atill In pro* 
press during the operations carried out bv the Interpreter 
end perhaos even after the command has been fully Processed, 
Henee In step 11# * Is not Immediately Printed on completion 
reeall • it Is stored for output at the next interrupt. 
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11* If • new contend must now he Initiated because the 
oresent one either consisted of comment only (by 
step 5) or has been processed (by step 12)# cheek 
the program exit. Tf this Is to the System Welt 
Loop In the 9VT# Indieating thet the system Is in 
feet normally under the control of the Monitor In e 
listening state# Initialize the Command Buffer po- 
inter end exit.es in steo 10 with S renlaeing . In 
the Eeho Buffer, Otherwise elear the Commend 
Buffer pointer to foree new CT&L/C end exit through 
etep 9 to. reset the Echo Suffer pointers and 
re-enable input keyboard Interrupts (1), 

12, At the eommon exit reeall# remove the return param- 
eters stored on the ataek and check PI. If this Is 
positive# no errors were detected during the execu- 
tion of the command lust finished# so eolleet the 
start address for the Feho Buffer frgm the KS9 pre- 
amble (see previous section) and exit through step 
11 . 

13, For negative R1 signifying thet error orint Is re- 
gyired# set up an EMT 30 eall to an overlay assumed 
to start at the next adjacent syatem-devlee block 
in the avstem Library and exit to it. (2) 

14, When the overlay. Is ealled# restore Registers 

passed by the driver and clear the return parame- 
ters from the staek. Use the value in R1 returned 
by the command processor to aeeess a table of mes- 
sages# eaeh of which. ends in a character with Its 
parity bit set (bit 7), Output characters (In 
non-interrupt mode)# until this eharaeter Is de- 
tected and follow with CR/LF# Reeall the driver 
proper bv Emt 31 to complete the clean up as shown 
from steo 12. (R1 now positive). 


1, As shown in the previous section# the Interrupt Is reen- 
abled to resume, program printing as part of the final 
elean-uo by the Listener • otherwise the printer remains 
disabled until pressed into seme new service. 


2, KBL must also therefore be assembled with a relevant 
parameter taoe as noted in Section 6,2.2 for tfce ether com- 
mand modules. However# It must be linked alone as It has 
its own EHT. 
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6 .3. 3 K» vbo tro Command lot cm peter ( K B I ) 

The Interpreter exists# ss discussed In Section 6,2.2# In 
order, to ensure that the two-letter eode entered as s eem- 
mend Is vslld snd then to pess control to the appropriate 
routine to oroeess the command# if necessary arranging for 
Its loading fro* the system-dev 1 ce. If the eode# however# 
is currently unassigned or ecr responds to s command handled 
only by the transient Monitor (see Section 6,6), the Inter* 
preter must so Inform the operator. 


Cel 1 Seoueneel 

The Interpreter Is orineloallv celled bv the Specie! Driver 
and therefore exoeeta Register contents as listed for that 
modules exit state in the previous section. It else assumes 
that the driver may be recalled for the common exit eeauenee 
• henee the ateek-atate must be eat accordingly (see Figure 
6*2). No other arguments are needed# henee the simple eel! 
sequence iai 


EMT 33 fCALL KBI 


General Description! 

The Int$roreter extracts the first two bytes from the com- 
mand line passed by the calling routine and then moves the 
pointer beyond the first spaee (or eomma) to the start of 
the eroument string or to the terminal CP If none. For the 
WAIT# CONTINUE and STOP commends (see sections 6,3, 3,1 
through. 6,3,3,3)# the current system state Is cheeked and 
where correct# the Interpreter modifies the proarfm exit on 
the stsek to refleet the change of etate resulted bv the 
command end takes aueh exit through s KBL recall. 

All other cgmmand codes ere covered bv an 1nd?x ahowlng the 
evstem device locations of the cor respondl ns routines as 
discussed In Section 6,2,2, Since the index oroper Is also 
stored on the system-device In segments# the Interpreter ex- 
amines an embedded seoment table to determine the block re- 
quired, It then uses Its own DDB to read that block on too 
of the WAIT# CONTINUE and STOP processors. If the command 
Is valid# the appropriate entry In the Index Is used to bu- 
ild the svatem device data for the processing routine and 
this is then called bv EMT 30. 

For a command eode not included In its expected index seg- 
ment (by implication this also eliminates a si ngl e-1 etter 
command)# or for an. Incorrect machine state for the embedded 
commands# the Special Driver Is recalled to print the rele- 
vant error message • see below. 
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Exit State! 

Data passed In Realsters from the Interpreter t© the Indlvi* 
dual command Processor or on Driver recall Is as Hated In 
Section 6,2. 5.1, In the recall ease, Rl in eartieular may 
have the followina eontentt 

m\ m Command doee net exist and la tharefore 
T 1 1 eoal 

•2 » Command la Invalid at thia time 
♦ X ■ An Input WAIT, STOP or CONTINUE h«a 
been executed 


In all. eaaea, the ataek la left aa at the point of eall from 
the Soeelal Driver (aee Figure 6*2). 


Detailed Proeeaalng* 

The processing ooerationa of the Interpreter are outlined 
below and are further llluatrated at Floure 6«6. 

1, Restore reelater contents paased bv the Special 
Driver and clear its return parameters , from the 
stack. Extract the first two characters from the 
command Inout and save them for later. If there is 
only one available before the terminal. CR, go to 
step 9 to set up and call for error print, 

2, Sean the atrino for the first oceurenee of aeaea or 
eomma and leave the buffer pointer at the next 
character, Tf the terminal CP la seen before this* 
hold the pointer on it. 

3, If the Input code represents a command processed 
within the Interpreter, namely. MIT, CONTINUE and 
STOP, qo to the appropriate routines aa described 
in sections 6.3,3,1 through 6, 3, 3.3, 
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4, Set oe^ters to an Internal DOB - aee Section 
3, 1,2, 3 -and to • table Identifying the different 
segments of the index for the processing routlnea 
stored on the system device, (1) 

5, Determine the Index segment for the range in which 
the Input code falls and compute the eor reaoomdl no 
system-device Mock number for. the segment on the 
basis of Ita relative Doaltion from the start of 
KBI Itself# as Indicated bv the *RT data stored In 
front of the KSB by SA M (see Section 2,3,1), 

6, Prepare the internal DOB for the reading of this 
block Into the area in the K38 presently oeeuoled 
by this aet-up routine# the 1 ndex-seoment table and 
the embedded command oroceasora (82 words current* 
ly). Use the DD^ entry In the 8VT (see Section 
2,J,l) to obtain the address of the system-device 
driver and force the comoletlon return to eall the 
driver deoue;ue# validity check and DDB clear se- 
ouenea sat up for SAM (see Section 2,3.4), Set the 
DOB busy fleo, 

7, Save the current Register contents on the ataek ua- 

Ino the Monitor S.RSAV routine (see Section 2,4,1) 
and pall the svstem-dev 1 ee driver via S,CDB (see 
Seetlon 3. 1,2. 4), Call .WAIT until the 

read-t ransf er is complete, (This requires a user 
Link-bloek simulation# l,e«# the DDB address is 
stored on the ataek followed bv a pointer to its 
staek eositlen), 

8, When recalled# restore the Register contents using 
S.RRES. Seareh the Index seoment for the command 
eode and at the same time# build the system-device 
data for t K e eorreaoondl no processing routine# 
starting fro" the MRT entry for the Interpreter and 
accumulating the sizes of intervening routines* If 
the eode Is found# eall its routine by E M T 39, 

9, If the inDUt command eode la not in the index aeq- 
ment loaded# recall the Snecial Driver to print an 
"Illegal Commend" message and return to the inter- 


1, Currently one. segment only is needed to caver the whole 
range of the assigned codes. However# for expansion# three 
segments are possible and if needed the table is a list of 
the last eodes covered by a segment in eaeh ease • aseeoding 
order assumed - followed by -1 as a stoo value* 
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runted program. thus Ignoring the operators re- 
guest . 


6.3.3. 1 T he W AIT Command 

The WAIT command enables the operator to suspend a Program 
temporarily while atUl allowing any I/O operations current- 
1v underway to complete. It is obviously. val id only If a 
prooram is loaded and running, hence It can only be used 
after the Input of CTBL/C and Its format Is thus! 

aC 

,WA[IT]<C9> 

When given control by the. Interoreter* the WAIT processing 
routine eheeks the *U5 in the SVT (see Section 2.1. t). If 
this is not 1#1 Indicating a program In and running, the 
command is rejected by a recall of the Special Driver to 
print an "Invalid Commend" message and exit. Otherwise the 
upper byte of the mus Is complemented to give a content of 
■1.1 slonifylng that the loaded program is now suspended. 
In order.to Produce the desired wait state. fhe program re* 
turn address saved on the staek Is switched with the content 
of WRA in the SVT which Is always Initialized to the address 
of the System Walt Loop. Thus It Is to this loop that the 
return Is made, when the Soeelal Driver is recalled to take 
the program exit, and the program resumption address Is 
saved in ease the operator later enters a CONTINUE commend, 
Bv the normal processes of the Driver described in Section 
6.3.2. the fact that the Monitor Is now In a listenin'* state 
is signalled to the operator by output of $• During the wa- 
It. the Registers are restored to their program content pri- 
or to the interruption caused bv the command. 


6.3 .3.2 T he C ONTINUE Co m m a n d 

The CONTINUE command is the natural complement of WAIT. 
However It mav also follow a suspension forced by the detec- 
tion of some "Operator Action" error to be diseuaaed in 
Chapter 7. Since It can only be meaningful if a program Is 
loaded and suspended, the Monitor must be In a listening 
state. Henee the normal usage of the command 1st 

SCOrNTINUE]<CP> 

Although a different mask Is used to ensure that the MUS in 
the SVT Is currently set to show the correct system state 
noted above, i.e. -1.1. the Interpreter calls the seme rou- 
tine to process the CONTINUE as was described for WAIT In 
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the previous Section fori 

s • The muS complement operation eetly produces the 
reouired new value of 1.1 • program loaded and 
runnl no, 

b, The address switch reinitializes WQA to the ad- 
dress of the System Walt Loop and the eventual 
exit throuoh the Special driver resumes the 
program from the point et which it wes suspend- 
ed with Peolsters again aporepr 1 atel v restored. 


6.3. 3. 3 The ST OP Commend 

STOP is provided es en emeroencv commend to halt everything 
m Including current I/O. Its usaoe Is similar to the WAIT 
command outlined In section 6.3.3.I. i,e,.l 

aC 

,STrOP]<CR> 

It is else Processed by the seme routine as WAIT, except 
that l 

a. The HUS content is further complemented to give 
• 1 ♦ - 1 to signify that the program is not only 
suspended. It is also stopped, (Henee It can* 
net be followed by e CONTINUE to resume the 
programs, ooerat lens « a necessary restriction. 

' -muse o? t 'A rot •(*.<: \ a ; 1 i ♦•".omelet* 1,0}. 

1. rent I/O • . ,f ) )•« »♦ «-e use of e RESET In* 

structlon (the real-time clock else If this Is 
present in the eenf lourat ion) . 


6.4 Run-time C ommends 


In Section 6,2 It was shown that most of the commands avail- 
able to the operator at the console keyboard can be given 
even thouoh a user program is loaded. Thev therefore are 
processed by Individual routines operating from the KSB, 
The purpose of this section Is to consider eaeh of these 
commands end the cerrespondl ng processing operations from 
the point et which control is received through the eommend 
Interpreter discussed in Section 6.3,3, It should again be 
noted however/ that seme commands ere not Included here be- 
cause they ere Illegal unless the system is occupied bv the 
Monitor alone. These ere described under the transient Mon- 



DOSft.PNO 


PAGF t 2 9 


1 tor i n Sect Ion 6.5. 

The routine* are discussed in the order In whieh they anoear 
within .the combined keyboard language load module mentioned 
In Section 6,2,3, It will be assumed that the reader Is now 
familiar with the common calling and exit seouenees and the 
cor resoondl ng state of the Reolaters and stack# as detailed 
In sections 6.2.4 and 6.2.5. The remarks on Internal 
conversions also aoolv. 


6.4.1 The DATE Comma nd ( K B T , 0 A ) 

In order that the current date can be available for Inclu- 
sion within the Identification of files held on bulk media 
(see Chapter 4) and perhaps for outout on prearam 1 latinos# 
a word Is reserved within the 3VT (see Seetlon 2.1,1) for 
Its storage. The DATF command Is provided as the means 
whereby the .operator ean Initially enter and later examine 
the content of this word# with an external form in olein 
lanouaae. It can be used at anv time. 


Command Format* 

For the entry of a new date# the DATE command has the form* 

D*tTEl f>D-MMM-YY<CP> 

hhere DP ean be uo to two decimal diflits for "day"# MMm re- 
presents the first three letters of "month" end VY shows the 
last two dlolts of "year", e,o, 1-3EP-71, 

Bv omitting the argument# the ooeretor reouests orlntlna of 
the currently stored date In the same "DD-MHM-YY" format. 


General Description* 

The basie operation of the PATE Processor merely regulrea 
the appropriate conversion between the plain language 
"DD-MMM-YY" and the sinole-word Julian format In whleh the 
date is stored In the 3VT. I.e.i 

1 dflP ( Year-7<3) tDey of the Year 
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For either inout or output# the commutation of day of the 
year involves • aeareh through • table of months# identified 
bv their three letter code# end the eorresgondi ng days in 
eaeh. ,Yeer end actual dev are simole decimal ASCTI/binary 
conversions • bv embedded routines for reasons oiven ear* 
1 ier(l). 

However both forms of operator reouest eennot be handled 
within a single module. Therefore o« entry from the Inter* 
prater# an immediate eheek is made for the presence of an 
argument and if none has been entered# indicating outout re* 
quire$J# an overlay is called to preeeaa it uaino FMT 3® as 
described in Section 6,2. 

The commend is rejected on the grounds of "Illegal Syntax" 
if a data being entered hae ineorreet format. An apparently 
invalid date already stored is printed sal 

00-xxx-( Year) 


Exit State* 

Both the input and output aeetlons of the DAT? ereceesor re- 
call the Soeeial Driver daaeribad in Section 6.3.2 as their 
means of return to the interrupted program. Hence Pegiater 
and steek are as detailed in section 6.2.5. Tn particular 
Rl# is sat to -3 if errera in the syntax of the argument are 
doteeted. 


i. Due allowance is made for February ?9th in any 
four-vaarly laao year. The century adjustment is however 
ignored (2100 is still a little way off)! 
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Detailed Processing* 

The form of the OATE processor Is 1 1 1 ust rated at Figure 6-7, 
The main steps In the sequence of operations follow! 

5, Restore Register contents passed bv the Interpreter 
and remove Its return parameters from the stack. 
If there Is no data in the Command Buffer for pro- 
eesaino or the first eharecter of ouch data la not 
a decimal dlolt, compute the deviee address of the 
start of the next module In the svstem Library (in 
MRT format) and eall It by E^T 30, Continue from 
step 6. 

2, Sava the currant content of tha SVT bate store and 
elear It as a buffer for the eonvers 1 on^ of the In- 
out eroument. Convert valid decimal digits into 
binary bv the standard "multiply bv 10 and add" al- 
gorithm, If the conversion la stooped bv recogni- 
tion of - and the result Is not greater than 31, 
dore it In the SVT, Otherwlee go to step 5 to re- 
sort the error. 

3. Sat a eolnter to a list of months and their eorres- 
oondlno davs. Search the list for the three-letter 
combination equivalent to that In the argument, at 
the sa-a time building "dev of the year" In the SVT 
store. Again oo to step 5 If the reouired combina- 
tion eannot be found or the subsequent Input char- 
acter Is not •• 

A, Return to step 2 to convert the decimal digits for 
"year". On return (forced bv the feet that the SVT 
entrv Is no longer 0 when the conversion ends), 
look for a Leap Year, If found and theday of the 
veer Is bevond February 28th, Increment it. Reduce 
the year value to 70, allowing that 00 entered now 
becomes 30, and sat the result Into the h1e»h order 
7-blts of the SVT store. However re]eet the com- 
mand through steo 5 for anv year seemingly below 
1971 or above 2069, On completion, reeall the Spe- 
cial Driver, 

3. For anv error noted in the previous oroeess, set R1 
for "Illegal Svntax" and restore the original SVT 
date before Driver reeall, 

8, when the outout overlay h*a been loaded into the 
K$B, restore Registers saved on the steek bv the 
eall and remove the return parameters. Set a po- 
inter to a list of month Identifiers and eorres- 
eondlng davs. 
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7, Collect the current Data from the SVT and extract 
the vaar bv counting successive successful subtrac- 
tions of 1000, starting from 69, If tha faault re- 
presents a Leas Yaap adjust tha dav value fop Fe- 
bruary In the Hat . 

8, Reduce the remaining day of tha yaap by tha day 
eounta atoped in the liat aa fap as possible and 
hold the. pointer at the nelevant month Identifier 
Cl), If the Hat and la reached before the reduc- 
tion la complete, Paaat tha Pointer for a month XXX 
and the remeinlng dav to 0, 

9, Convert tha day into 2 decimal digit# by the simple 
"Subtract -10" algorithm and sand to the eonaele 
pointer followed bv 

10, Print the appropriate month identifier from tha 
list terminated bv - , Return tip step 9 to convert 
the year value, again providing for the cutout of 
100 aa 00, ate. On completion, reatgre the printer 
carriage bv CR/LF and reeal 1 the Special Driver, 


6.4.2 The SAVE Co mmand (KBI.SA) 

Tha SAVE command la. provided to enable the user to produce 
external modules from. a eurrant eora image uPon any aepre- 
prlate device and In a form acceptable to the Program Leader 
for later reentry (see Section 9,1), In order thft the SAVE 
processor may have full aeceas to all Monitor facilities, 
especially the FI 1 e-manegement routines, the normal Swap 
Buffer must be readily available. Hence to avoid problama 
of conflict ever MSP usage, as generally discussed in Sec* 
tlen 6,2, the SAVE command mav only be given at times whan 
the leaded program is unable to perform, i,g, either before 
It is started after a GET command or after it Is oermenentlv 
suspended bv a STOP command or some fatel error. 


1, After step 7, the remainder Is neoetlve. The reduction 
Is In feet . therefore accomplished by addition until a posi- 
tive value is detected starting with an increment to make 
December 31st s day 365 and than working backwards through 
the year. 
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Command Format! 

Basically, the SAVE command may have one argument aa 
f ©1 1 ows > 

SSATVF] [Dataset spec 1 f i er] <CP> 


Where "Dataset specifier" must comply with the format for 
the Command String Interpreter (see Section 5.4),l,e, 

roavleeil [F1 l ename (, Ext enaion] 1 [UIC] r/PAiLOWiHlGH] 

(PA being a switch Identlfylno the range of the SAVE image 
between the octal addresses LOW and HIGH) 

As Indicated, elements of the aoeelfler may be omitted In 
whleh ease the followina default assumptions are provided! 

a. Device • the svstem-devlee as stored In the 
first entry of the DDL (tea Seetlon 2,1,3) 

b. Filename and Extension.* SAVE.LDA (also eausas 
auto*del at 1 on if aueh file already exists) 

e, UIC * the Identification eode for the leoged-in 
user as stored In the SVT (see Section 2,1,1) 

d, LOW • the Program Load Address In the SVT (PLA) 

e. HIGH • the highest address In available memory 
from the SVT (GSA) 


General Description! 

Because the aetual SAVE operation can be a lengthy oroeess 
and Is likely to Produce normal errors for which the *8* nav 
be needed by the Diagnostic Print routine (see Chapter 7) 
the SAVE processor is dlvi ded Into two main sections! 

1, An initialization routine, called wy the Inter- 
preter Into the KSB to cheek and deeode the co-mand 
argument ■ 

2, The SAVE routine proper, brought into a 236-word 
buffer claimed from free core by the inital liatlon 
routine to produce the reaulrgd load Image by nor- 
mal I/O operations# with the KSB then freed for 
other usage. 

The Initialisation oroeess In fact uses the Command String 
Interpreter (see Section 5,4) for Its operations. This me- 
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•at that the necessary buffers and control bloeks must be 
provided, Owing to th* limited capacity of ,the KSB and to 
avoid the use of core outside It until the ingut specifica- 
tion is completely verified# the routine is organized as 
at raloht-1 1 ne eode which successively overlays Itaelf with 
the CMDBUF and Line buffer containing the Input argument 
needed by module CSX and then the Command*# Link* and 
Flle-bloeka expected. by CSM. Finally an Internal DDB (see 
Seetlon 3. 1.2.4) Is similarly prepared for the transfer of 
the SAVE processor Into Its free-eore buffer from the 
svatem-devi ce. However If anv error la detected# the eom- 
mend .1$ rejected. bv a recall to the Special Driver with ap* 
prooriate diagnosis (see below) 

The SAVE Processor Itself must of course move the date esta- 
blished, by CSI out of the KSB into Its own Link* end 
File*blpeks with default values supolled as relevant. Ones 
done# however? the KSP is released and the Listeners Pointer 
Store is rei ni t i el i zed (see Seetlon 6.3.1). with keyboard 
interrupts then reenabled and processor oriorlty reduced to 
0# the actual SAVE routine becomes Juat another running user 
program, It uses the standard .. INIT# .OPEN# 
.WRITE# .CLOSE# .RLSE aequence to output the formatted binary 
data aa illustrated under Seetlon 5.1. During the f WRlTE# a 
double-buffering aeheme is adoptedi this again utilizes a 
once*only cede area.wjthln the SAVE proeessor.to obviate the 
possibility of inauffieent free eore outalde it. 

The SAVE processor algnala ita completion by restoration of 
the implied Monitor 1 latent ng. state from whieh it was origi* 
nelly entered (* output end forced input aeeeotenee). It 
muat then releaae the buffer it oeeuoies. To accomplish 
this# it uses the same teehnloue as the Fi 1 e-manaoement mo* 
dulea jn. the aame oredieament (see Seetlon 4.3)# in whieh 
the Monitor S.RLB routine is celled and returns through the 
normal System Exit described in Section 2.3.4. This re* 
stores the Registers whieh were originally saved on the 
staek by the Listener before the command was processed and 
whieh are at 1 1 1 there • The flnel exit returns to the Svs* 
tern wait Loop. 

Any errors arising during the aetual SAVE cannot of eourse 
be handled through the Special Driver once this is no longer 
at the oroeeasora disposal. Hence the appropriate measaoes 
are printed bv the processor itself before it returns to the 
System Wait Loop aa described in the previous paragraph. 
I.e. 


a. File error XXX - where XXx la the error code 
returned in the File-block Status (see Pro- 
grammers Handbook) 
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b, Device Full 


Exit State! 

During the initialisation proeass# the Special driver may be 
raeallad to handle error messages# henee the Register and 
Stack state must ba as prescribed In Seetien s,2,5 with R1 
In particular set as follows! 

• 2 ■ A usar program Is net loaded 
or Is not stopped henee the 
command Is Invalid 
•3 ■ Faulty Syntax 

-6 ■ Illenal limit addresses# l.e, LOW 
>H1GH# or outside core 
-7 ■ Wo buffer spaee available for the 
actual processor* 

AS noted above# the aetual SAVF routine does not return 
through the common keyboard language exit* Thus It ensures 
Itself that tha Registers and staek are returned to their 
state prior to the command Interrupt, 


Detailed Processing} 

As indicated under "General Description" above# the SAVE op- 
eration Is performed in two parts# These are described In 
tha following paragraphs. The 1 ni 1 1 al 1 sat 1 on process# being 
mflnlv straight-line coda needs no illustration. It Is out- 
1 1 ned below* 

1* Restore Register contents passed by the Interpreter 
and remove Its return parameters from the stack. 
Compute the system-device block for the SAVE pro- 
cessor orooer on the basis that it follows the Ini- 
tialising routine in the system Library and save 
for later* Set a. pointer to the start of the rou- 
tine as the beolnnino of a CSl CMDBUF with a Line 
buffer following. (see Section 5.4) 

2. Cheek the MUS In the 8VT (see Section 2.1.1). If 
not set to either 1#<* (orogrem loaded but not 
started) or -1,-1 (program suspended and stopped)# 
recall the SPeelal Driver to print an "Invalid Com- 
mand*! message A Ignore the command* Ensure the MSB 
is free by clearing any current Usage Count (see 
Section 2,3,1) 

3, Move the command argument string unto the "Line 
Buffer" section relative to the pointer set In step 
1 and ensure that a correct line terminator fol- 
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lews. Call CSX (Section 5,4,1) to eheek the over- 
all syntax. Recall the Special Driven to print an 
"Illegal Syntax" mesaeae If In error end reject the 
command, 

4, Prepare dummy Link-, File- end CSI Command-blocks, 
(Error return addresses I Stetua words for tha 
first two are unnaeassarv at this stage • _ however 
the Link-block muat allow room for a four-word 
jwjteh - see Section 5,4.2), Indicate outogt spec- 
ification required In the CSI CMDBijF end cell C8M 
to. decode the argument, with error aetion as des- 
cribed In step 2. 

5, If the RA awiteh la present In the command String, 
eall the Conversion Utilities routine (see Section 
5.3) to convert tha llmlta glvan to binary values 
and store them In the Link-block Instead of their 
start pointers as returned by C3M, If LOW ia not 
lass than HIGH or HIGH la above available ceret re- 
call the Soaelal Driver to toil the operator and 
again reject the command. 

6, Via the Monitor S,GT9 routine (see Section 2,4,2), 
elajm a 256-word buffer from free core. If none 
evelleble, inform the uaer through special Driver 
reeal 1 

7, Prepare an internal DDB (sea Section 3, 1.2, 3) to 
read the 256-word SAVE processor . into the new 
buffer from the stert block cemeuted earlier. 
Extract the system-device driver address from the 
DDL (sea Section 2.1.3) vie ite pointer in the 3VT 
and forea the completion return to use the SAM se- 
quence described In Section 2,3,4, use soars DDB 
locations to save relevant Registers (and sat tha 
DDP busy flag) 

8, Call the system-device driver to affect the 
transfer via tha Monitor S.CDb routine (see Section 
3. 1.2,4) and call t HAIT till dona (likf step 7 in 
the Interpreter jn Section 6,3.3, this requires a 
Link-block simulation). Whan recalled, restore re- 
gisters sayed In the previous steo and Jump to the 
loaded routine. 

The SAVE routine oroper. Is Illustrated at Figure 6-S, Its 
basie steos are as follows! 

1. Give tha. SAVE routine now the appearance of a ^load- 
ed running program by resetting MUS in tha 3VT to 
1,1 to allow normal usage of the keyboard language 
during the output phase (after saving tha original 



D0S6.RN0 


PAGE (* 37 


MU8 content) 

?. Move Into an Internal fuM Link-block the device 
na*e and unit stored In the *98 dummy bv CSM or. If 
none# the name of the system-device from the DDL 
with unit set to 8(1) 


9, If the KSB dummy File-block contains a 

f 1 le-soeel f Icetlon# move the relevant data Into an 
internal full block to overwrite the default as- 
sumption SAVF.LDA already Included and sat a swlteh 
to prevent automatic deletion If the file la seen 
to exist later (see steo 6), Also store anv UIC 

spec 1 f i cat 1 on, 

A. Set pointers to use the area occupied by the pro- 
cessor up to and including the cell for ,0PEN in 
step 7 as a double-buffer. In the first of these 
buffers, oreoare a standard COMD block for the load 
Image as described In Section 5,1, uslno the Range 
limits# If any have been supolied, or the Program 
Load Point and the top of available memory If not. 

Fill In the remaining Items# e.o, _ Program and ODT 

start addresses and program name# from the existing 
entries In the SVT. 

5, Remove the keyboard Listener recall addresses from 
the staek end use Its saved pointer to reset its 
Pointer Store (see Seetlon 0,3,1), Simulate an in- 
terrupt return on the staek with 0 priority level 
and use the KSB releese seauenee stored below It 
(see Section 0,5,3) with RTI as the final instruc- 
tion, On reeall# reenable keyboard interrupts, 

ft, Reauest .INIJ uopn the outDut dataset and If the 
specified file Is the default SAVE, LDA, try to de- 
lete It, (The File-block error return Is set to 
come back at the same oolnt If It does not exist), 

7, Reset the Fiip-bjock error return to call a se- 
quence which prints a "File Error" message and ex- 
its through step 11, Call .OPEN, Amend the buffer 


1, T h e error return in the Link-block is set to 0f thus if 
the. reoulslte buffer soaee for normal I/O operations Is not 
available# a SAVE command can result in a standard fatal er- 
ror (F0P7) - see Section 3, 2, 1,1, 



DOSfl.RNO 


PAGE t 38 


pointers for fillinq the eeeond buffer end Initiate 
a formatted binary .write for the COHO block now In 
the first, 

8, Store the current load ooint represented by the 
start of tha data area now being outout followed bv 
the actual data words until the buffer Is filled or 
until tha hlah limit Is reached. Compute tha 
number of bytes moved and store in tha appropriate 
third word of the Line h*eder_(eee section 3,?, 2), 
Call .WRITE to outout the buffer now filled (In 
formatted binary) 

9, When recalled, eheek whether EOD occurred at the 
lsst .WRITE. If so, print a "Devleg Full” message 
and oo to step 11 to exit. Otherwise switeh tha 
buffer pointers - the other buffer muet now be emp- 
ty. Go baek to steo 8 If more data remains to be 
output • 

18, When tha high limit is reached, prepare and outout 
a terminal Transfer Bloek using tha address stored 
st PSA In the SVT (sea Seetlen 2.1.1). Than eall 
•CLOSE and ,RLSE on the dataset. 

11. Restore tha original svatem-state saved at step 9 
to. the HUS in tha SVT and anaura that the System 
Wait Looo is recalled on exit. Output S and force 
command Input acceptance by resetting t keyboard 
te*m**d Suffer *»«M«er t*a* **e*i«*n S;ope 

*'»ntam axir *ddf*«« mm the stack and Jump to 
the Monitor S.RLB routine (ee noted under "General 
Description” above.) 


6.4.3 Tha ECHO, END 8 PRINT Commands (KBI «KB) 

This Saetjon eovars three commands which are Primarily in* 
tended , to . eneble the uaer to control the eeneoJe terminals 
operations on behalf of a running Program. Because their 
processing is. similar, they are Included within tha aama mo- 
dule). In oarticular they are all invalid unlese a user pro- 
gram is loaded and the full driver la in core. The eommsnds 
are I 

a, ECHO - which allows flip-flop control of the 
echo printing associated with keyboard but does 
not affeet normal output. 

b. PRINT • which provides th« same facility for 
normal outout but not echo-print. 
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e, END - which enables the user to slonel the end 
of a sat of input data* 


Command Format t 

The basic format acceptable for all three commands Is the 

aamai 

EC[H01 tDevleel <CR> 

PRtlNTJ [Dav leal <CR> 

EN[D t0ev1eel<CR» 

phere "device" Is tha conventional two/thpee eharactar coda 
for tha device eoncarnad (without i) and Is bv default kb 

Howavar tha device In tha easa of ECHO and PRTNT must be a 
terminal/, the only one currently Implemented being KB - 
hence It is omitted In tha oresent description In the Pro- 
grammers Handbook* Nevertheless It can be specified for 
other terminal devices# provided that tha associated driver 
Is sat up to use tha results of the proeesslna described be* 
IQW. On the other hand# END does not have the same restric- 
tion but again tha only driver which recognises Its ooera- 
tions Is that for the standard A$R»33 Teletype. Hence KB 
and PT are tha only meaningful spee 1 f lest ions. 


Ganaral Description! 

Provided that all the. requl rements noted in tha previous 
paragraphs are satisfied# tha processing for the three com- 
mands requires aeeess to the byte in the device driver In- 
terface Table which contains the priority level used to set 
the. 1 ntf r ruot vector (sea Section 3#3*i)« Since this Infor- 
mation Is only required whan the driver is first loaded# the 
bvta can now be used as a sat of switches as follows (assum- 
ing an initial value of 200# 1,e, PRL4)i 

Bit 7*0 - EDO 

Bit 4*1 • Suppress eeho (operetor-cont rol ) 
Bit 3*1 - Suporess echo (eroqram-eont rol ) 

Bit 1*1 • Superass print (ooerater-eent rol ) 
Bit 0*1 - Suporess print (proorem-cont rol ) 

The ECHO and PRINT commands merely complement the relevant 
bits (4 end 1) raspaet 1 val y » FND clears bit 7, It Is than 
the responeibl 1 1 tv of, the driver to cheek the appropriate 
bit as required and to act accordingly* 

It should be noted that because no attempt is made to eall 
the driver# the command een only be affective when the 
driver again has control. If In feet# the orogram has alre- 
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ady reguested .READ and the driver ha* then returned to awe* 
it an interrupt, an END.reouest particularly must be fol- 
lowed bv a new program inout to foree eueh interrupt, Hence 
it ia recommended that a double CP be used to terminate the 
commend. The user is also warned that onee the EOD switch 
is set, it is cleared only by an OPEN cell to the driver or 
bv a reload on .INIT after .RLSF. Thu* if more then one da- 
taset is sharing the driver, the EOD coolies to ell - a bo* 
tential problem if sav both commend strinps and data are be- 
ing entered from the same keyboard. 


Exit States 

All three commands result in Special Driver recall on com- 
pletion or error. Henee Registers and staek ere set as 
shown in Section fl.2,5, Ri in particular may indicate the 
following error conditions! 

*2 ■ No proqrfm loaded, so the eommend 
is Invalid 

•3 ■ Faulty Svntex (i.e, non-al ehabet i c 
characters in device name) 

•4 ■ Illegal Device (which does not exist, 
is not in memory# or is not a terminal 
for ECHO or PRINT) 


Detailed Processing! 

The seguenee of operations needed to Process th# three com- 
mands is outlined below. It is st raioht f orwerd and thus 
needs no supporting illustration! 

1. Restore Registers passed bv the Interpreter & dear 
its return parameters from the stack. If the 
low-order byte of HUS in the 8VT is net set to t to 
show a program is in eone (see Section 2.1.1)* re- 
ject the command bv recalling the Seeeial Driver to 
print an "Invalid Command" message. 

2. Convert up to the first thnee letters of any argu- 
ment string entered into 1 ef t* Just i f i ed radix-50 
format (see Section 5.3). (Anv non-el phabet ic 
character other than space. Comma or CR is "Illegal 
Syntax"). If no argument is given, substitute KB, 

3. 'Jsino its SVT pointer, access the DDL (see Section 
2.1.3) and look for the device (KB acting also for 
PT sinee both devices share the same driver - see 
Appendix A), Reject the commend on the grounds of 
"Illegal Device" through the Special Driver if ei- 
ther the device is unknown Or its driver is not in 
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eere. 

4, Fo^ ECHO and. PRINT# eheek the nature of the devlee 
by, examination of the Facilities Indicator 1* the 
driver Interface Table (tee Section 3,3,1), Again 
the devlee It illegal unless It it a terminal, 

5, Set an aporoeriate mask fen the command reouired 
and perform the relevant bit ooeratlon at noted 
under "General Description" above (complement • 
ECHo/PPINTt clear • END), Return to the Interrupt- 
ed program throuoh the Seeelal Driver, 


6,4, 4 The OPT Comma nd (K0I.OD) 

LINK-11 gives a uter the opportunity to Identify 0DT-11R at 
a module within a proaram load-lmaoe bv its /OD twitch, 
(tee DEC-l 1-ZLDC-D) • The atert addrete of |the module It 
then etored within the COHO bloek In front pf the load mo* 
dule (tee Section 5,1) and during the load process It la 
transferred to the SVT (tee Section 2,1,1), The ODT commend 
then olvet the uter the meant .whereby the debugging routine 
can be eel led or recalled reaerdlete of whether e running 
proaram^ 1 a in control or hat lost It as a retult of tome In- 
herent failure. 


Commend Format! 

At shown In th# relevant mangel (DEC-1 l-OPDA-n) , three entry 
points into 0DT-11R are pottlble. Hence the eommand hat the 
form» 

0D[T] [Code letterJ<CP> 

Where "eoda letter" may be at follows! 

a, (null) ■ completely initialize QDT-liR (ODTtfl) 

b, R ■ Remove breakoolntt currently set (0DTf2) 
e, Ka Keep current breakoolntt ( 0DTf4) 


General Description! 

Bv Implication, a proaram mutt be loaded (even if it It a 
linked yereion of 0DT-11R alone) and 0DT-11R mutt be Includ- 
ed within It, The eo-mand It rejected at Invalid bv Special 
Driver recall otherwise. 
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The command argument Is used to determine the 0PT-11R entry, 
provided that It Is a recognised value, However before con- 
trol Is transferred# the HOT command Processor must assume 
that the ooerator will expect conditions appropriate to his 
proaram and may later resume the orogrsm direetly from the 
debugging routine# Therefore# the system Is first olaeed In 
a orooram-run mode# all evidence of a command being underway 
Is removed and the. exit is taken with the Registers and 
ataek restored to their stste prior to the command Inter- 
rupt , 

Two points should be noted* 

t. The Monitor does not attempt to initialise ngT-llR 
either on loading or after an DOT command, This Is 
left to 00T-11R itself# if so ealled bv the user* 
In particular# the debugolng trap location at loca- 
tion 14 must be eorrectlv linked. Thus th« first 
OOT command should have no argument and should be 
entered as soon as possible after loadinq, 

2, 0DT» 1 l R always restores breakpoint locations tempo- 
rarily while It is In control# to allow the user to 
examine and modify these like anv other* It only 
reolaces them when the user calls for program con- 
tinuation by Its own commands for the purpose. If 
th« user Instead enters CTRL/C to reeall the Moni- 
tor, starts the drogra" by a Monitor command and 
then later uses the ODT command with an argument# 
00T-H R attempts Its restoration with its Initial- 
ising value P00003 thus destroying the original 
content. The user is therefore advised to exercise 
some caution (see "Getting DPS on the Air" • 
DEC-ll-SYOD-n) 


Exit State* 

If the Special Priver is recalled through error# Registers 
and stack are set as shown in Section 6,2,5, Tn particular 
R1 contains one of the following veluest 

•2 ■ 0DT-11R is not in eore# so the commend Is Invalid 
•3 ■ Code letter is unknown# hence Faulty syntax 

As noted above# commands acceptance results in an PDT-11R 
eall with program state restored. 
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Detailed Processing! 

The simple sequence 4s as follows end requires n© lllustra- 
t 1 on* 

1, Restore Registers oessed bv the Interpreter end re- 
move Its return osramters from the Steele. Reject 
thf command by recalling the Special Driver to 
print en "Invalid Commend" message if either the 
MUS in the SVT does not contain a low-order byte of 
1# signifying that a program has been loaded (see 
Section 2,1.1)# or DSA In the SVT Is set to 0 
(0DT-11R not present), 

2, Modify the content of DSA by 2 for an argument R or 
4 for K, Similarly reject the command for any oth- 
er Input on the grounds of "Illegal Jyntex", Store 
the resulting address on tha stack In place of the 
return to the Interrupted program, 

3, Clear the returnto the Special Driver from the 
stack. Using its saved address# rei nl 1 1 el 1 ze the 
Listeners Pointer Store (see Section 6.3.1), Walt 
until the console printer has completed the command 
LF terminator (see Section 6,3,2). 

4, Set the Mys jn the SVT to 1,1 to signify . "program 
in and runnino"_and ensure that wra Is initialised 
to the address of the System Walt Loop (in ease the 
command followed a fetal error • see Chapter 7) 

5, Restore the Registers saved at the command Inter- 
rupt - and thus clean-uo the stack and exit to 
0DT-11R at the required entry point. 


6,4,5 The BE GIN a nd REST ART Commands (*8I,BE) 

Tha BEGIN command Is provided as the means whereby the user 
can Initial ly start the execution of a program already load- 
ed by a GET command or earn later start over with a clean 
slate# perhaps after a fatal error, RESTART allowsthe user 
to transfer.control to a different point in a running pro- 
gram# possibly as previously established bv the program it- 
self using the "Set Restart Address" facility within the 
General Utilities oaekage (see Section 5,2), In this ease# 
current I/O Is stopped but all linkages remain. Both eom- 
manda_ there a considerable amount of eommon code! they are 
therefore Initially processed bv the same module# 
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Command Format* 

Basically# the command format for both BEGIN and RESTART is 
t^e same i,e,i 


BE [Gif J [Octal address] <CR> (1) 
RE[ START] [Octal address] «CR> 


An address araumant supplied In either case baeomes the 
start ooint for Program execution. If omitted# the follow- 
ing default values are usadt 

a, SERIN - the automatic start address included in 
the orooram source .END statement and as a re- 
sult of assembly# linking and leading# now 
stored in PSA in the SvT (see Sections 2,1,1 
and 5,1), Msvbe 1 - an Illegal address - if 


1, A reader who has the listing of the kbI.BE modulo may 
have noticed that a variation in the BEGIN format ia oossi- 
bla# i.e.t 


BE [GIN] [Octal addrasa] [S]<CR> 

where the optional aroument S# meaning SAVE# orevents the 

normailv automatic deletion of files currently goon for out- 

put. This was provided originally for the benefit ief a user 
who had already amassed a lengthy file* perhaps of irrecov- 
erable data#, by the time a program failure occurred and 

would therefore not want to lose it. However# there are two 

major problems inherent in the uae of this eroumenti 

a. The SAVE operation uses normal File-management pro- 
cedures to dose the filet in particular this means 
writing out data eurrently.in memory to the deviee. 
Since# in general# BEGIN in this ease is reouested 
only because of program failure* there is a high 
probability that this ia eprruoted data# thus 
spreading the effect of the failure to the device. 
With the proeram then beoun again* the eventual re- 
sult might be a disaster. 

h. Since the file would now exist (or files* si nee the 
oroeess is non-sel set i ve) * the program must be set 
up to use a different File-names for the rerun or a 
second failure oeeurs. 

Therefore this option has not bean advertized# instead sueh 
user is advised to KILL the program for* although this also 
performs a normal .CL^SE# he is than in a position to use 
PIP-ll to piek uo the nieces before it is. too late. 
References to this feature are omitted in later discussions. 
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no source address is suool ied) 

b, RESTART - the latest address stored at R3A In 
the SVT by a prooram reauest through GUT, 

Both commands require onlv that a program be loaded! Its run 
state is Immaterial, However because RESTART must be qlven 
an address and oerforma less initialization, its use before 
the prooram has been started seems pointless. 


General Description! 

As noted above, the proeessino for both BEGIN and RESTART 
commences at the same module, firstly to verify the presence 
of e loaded prooram and secondly to eheek the validity of 
the start address whether this be a conversion from an argu- 
ment supplied or the rel event . defeul t • Failure In either 
ease results In rejection of the command by Special DHver 
reeal 1 , 

The two comm»nds also share a common sequence for oenaral 
elean-u9 such as killing current I/O bv hardware RESET, 
re-inltjel Izlng the staek, the keyboard listeners pointers 
and various SVT entries and ensuring the vacancy of the MSB, 
Aoart from removing any I/O Busy Flags, RESTART processing 
Is then complete, A direct exit Is. therefore taken to the 
user erogram at the start point specified, with Registers 
restored to their content prior to the command interrupt, 

BEGIN however requires further ectlon and this Is effected 
In two overlays ealled consecutively into the KS8 by EMT 3& 
(see Sections 6,2,3 and 6.2,4), In the, first overlay, all 
the I/n linkage currently established is examined in detail 
via the Monitor DDB chain. Aoaln any busy flags are re- 
moved, but in addition each dataset is cheeked for a file 
remaining fully ooened (see Chapter 4), If sueh file is 
continuous or is linked and In use only for Input, it Is 
merelv closed, A linked file being created on the other 
hand must be deleted to allow the Program to reopen It bv 
the some name without a "File Exists" error, 0* a DECtaoe, 
this Is effected by removing the name from Its dlreetorvf on 
disks It also means that the blocks already allocated must 
be unlinked • an operation carried out Internally using 
,TRAN. This avoids the necessity for closing the file 
first, a potential cause of disk corruption (see Footnote to 
"Command Format"). An Fxtansion to an existing disk file Is 
similarly removed. 

The second overlev Is celled when the I/O eheeklno Is com- 
plete. Thjs then unlinks any buffers still allocated from 
free eore, i,e, Device Assignment Table extensions made 
after the program start (see Section 3, 1,2,2), the DDB chain 
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and device driver* normally non-real dent * and effectively 
return*, those buffers to free core bv clearing the Buffer 
Allocation Table (see Section 2.4.2). Tt also resets the 
Interruot vector tied to the driver* thus removed end en- 
sures that the resident drivers sre unlinked from any FIB 
chain, (see. Section 4.1.3). Finally It calls the program as 
specified with all Registers cleared. 


Exit Statet 

If the Special Driver is recalled on error* the Pedlsters 
and staek state are as shown in Section 6.2.5 with Pi set as 
fol 1 OW*f 


•2 a Program not In core# henee the command 
is Invalid. 

•3 ■ Address aroument containj other than 

octal dlelts or 1* too big* thus Faulty 
Syntax, 

-6 ■ Address to be used (ineludino a default) 
Is Illegal because It does not fall on 
a word-boundarv or Is outside the 
potential eroqram area* l.e. above the 
resident Monitor and below the too 
of available core. 

As noted under "General Proeessino"* an accepted command re- 
stores the system to normal prooram run-state with the stack 
eltsred to Program Load Point and Registers reset to their 
content prior to a RESTART or 0 for BEGIN. 


Detailed Processing* 

The eommom Processing for BEGIN and RESTART Is straightfor- 
ward and neeos no Illustration. Its b*s1e steps a re as fol- 
1 ows t 

1, Restore Registers passed by the Interpreter and 
clear Its return from the stack. Reject the com- 
mand as invalid through the Special Driver If the 
MUS In 3VT contain* a low-bvte of 0 (program not 
loaded • see Section 2.1.1) 

2, If any argument is supplied* convert valid oetal 
digits into thejr binary eguivslent until either a 
recognised delimiter (soaee* eomma* ©r CR) or sin- 
gle-word overflow. (Agsin reject the commend for 
Faulty Syntax for illegal characters or sueh over- 
flow), Substitute the appropriate default from the 
SVT for no argument. 
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3, Verify the legality ef the start addness# with aim* 
lisp, rejection If It la not on a word-boundary or 
within the program area as defined bv the too of 
the resident Monitor and that of available eere. 

4, When the console printer has eomelated the command 
LF output (aee saetion 6,5,2)# kUlall I/O bv RE- 
SET# but restart the llne-eloek If present (aa 
shown bv Its vector oolntfng elsewhere than the 
Trap error routine (see chapter 7) 

5, Prepare a new stack immediately below Program Load 
Point as saved In the SVT# with its first entries 
balno 0 for program-exeeut i on prloritv Jeval and 
the specified start point (1) 

6, Remove from the present stack the reeall parameters 
for the Soeelal Driver and use the address for the 
Listeners Pointar Store saved below them to restore 
normal run-time keyboard control (aee Section 

6.3.1) . 

7, Release the MSB by elearina anv outstanding Usage 
Count and Its Occupant-Identifier (sea Section 

2.3.1) , Also ensure that wra in the SVT contains 
the address of the System wait Looe (aee Section 

2 . 1 . 1 ) . 

S, Cell the. first overlay from the next system-device 
bloek If the command la BEGIN, For RESTART# traee 
the Monitor DDB chain from its start In the SVT 
(see Seetlon 3,1. 2. 3) and remove Busy Flags from 
the DDBs end their associeted device drlyere to- 
gether with anv S linkage (see Section 3«1.2 a 4) 

9, Set the MU3 in the SVT to show. "program leaded and 
running" 1»1, Restore the original program regis- 
ters# reset SP to the new stack prepared at step 5 
and exit bv RTI. 

The overlay processing now performed for BEGIN la Illustrat- 
ed et Figure 6-9. Aealn the following are the basic ©Dera- 
tions! 

1. Restore the Realstera to their state prior to the 
overlay call and clean uo the stack. Get the start 


1. If the stack was empty, before the command interrupt 
these, Items overwrite the interrupt return and henee eennot 
eerruot any other valuable data (see Figure 6-2), 
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of the Monitor DOB chain fro* the 3VT and if there 
it. no linkage currently go to etee 7 to e«U the 
«ext overlay. 

2. Remove the SVT DDB*link, For each ORB In the eheln 
faoaln tee Section 3. 1.2, 3), clear Its Buev Flag* 
that. of Its aaaoelated device driver end remove any 
9 Hnkaoe. Go to the next DOB in the chain If el* 
ther the Driver Interface Table), . (tee. Section 
3.3,1) shows the devlee to be non*f i 1e*oriented or 
though the devlee la f i 1 e*st rueturgd, there fa our* 
rently no file open, (l.e, poen-flao It clear end 
no FIB It attached • aee Section 4,3.2) 

3. Otherwise eneure buffer avalllblllty by ereearing 
one on the atack of a site aet at the etendard for 
the device (at. shown in the Driver Interface 
Table). Link this buffer to the DDB, 

4. Using a dummy Ltnk»^1oek overlaying the initial 
?nee«on1v code. of thla routine, eall .CLOSE if date 
In the FIB Indieatea that the file Is contiguous or 
1s_ open only for Input if linked, tote the oteek 
buffer and return to ateo 2 when done, 

5. For a linked file open for creation or Extension, 
orepare a dummy TRAN»b1oek (see Section 3 , 2 . 1 , 1 ) • 
again on top of the start of the routine • end use 
it to read in the aeprooriate di rectory . bleek from 
the devlee. (The FIB contains Ito Ident 1 f ieat ion • 
If none the .OREM cannot be complete « oo return to 
step 2). Clear the F11e*name from the relevant an* 
trv for a new file or unlock an old one being ex* 
tended and write. the bloek beek. . (The old file 
atill retains its . former identitv in the letter 
eaee • aee FIB deaeriot Ion) . 
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6, No further action Is required for DECtape# hence 
eheek and return to step 2 If the jr i vap r Faell 1 t v 
Indicator shows tMa la the devlea In uaa. 
Otherwise# again by ,TRAn, tpace the blocks of tha 
f 1 1 a » ataptlng from the FIB entpv for "First Bloek" 
and finishing when a * link la encountered# clear- 
ing all link-words In tha ppoeaaa. On completion# 
ratgrn to atap 2# again with the ataek-buffer Pa- 
moved (1). 

7, Call tha second overlay from the next system-devlee 
bloek and when In# peatoPa Reglaten contents as 
oassad. 

8, Collect tha stapt address for any Davies Assignment 
Table from BAT In tha SVT, If nen-0» tpace tha 
table linkage (see Section 3.1,2. 2) and unlink all 
segments above the top of the pesldent Monitor aa 
shown at EOM In tha SVT - since these must oeeuov 
free cere buffeps (see Section 6.4,9 also). 

9, Clear all words In tha Buffer Allocation Table 
between the limits stored at BFS and BFE In tha 
SVT. Reset TOP and Its stack-stop (see Section 
3.4,1) from FOM with the standard 4«-byte safety 
margin. 

10, Search the DDL (see Section 2,1, 3)1 for permanently 
resident drivers (signified by no system-device da- 
te) which are f 1 1 a-at ructured# dear bit map Po- 
inters? for non-resident drivers# clear their core 
addresses in the DDL and reset the device interrupt 
vectors to tree to the error routine. 


1, It should be noted that no attempt is made to modify the 
bit-map segments stored on the devlea# again to avoid possi- 
ble cor ruot i on . As shown In Section 4,1,3# the bloek allo- 
cation seheme uses an in-core segment during file-creation, 
Henee It follows thst If this Is not written to the devlee# 
the blocks alven to the deleted file within Its. ranee remain 
free for further use. However# there may still be some 
blocks which were allocated from a map segment whleh beeame 
full #nd was therefore replaced In memory. These are not 
reclaimed. It is possible# as a result# that a "Device 
Full" error ean oecur later even though other evidence con- 
tradicts this. Thus the. user Is advised to avoid excessive 
use of BEGIN as a means of resumption after prooram failure# 
particularly If lonolsh files ere Involved, (see "Getting 
DOS on the Air" - DEC-t 1 -SYDD-D) , 
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It. Clear ell Reolsters and exit to the program with 
the MUS in the 3VT eoain set to t?l and the stack 
removed to proaram toed point. 


6.4. 6 Th e KI LL C omman d ( K 8 1 , K I ) 

The KILL command enables the operator to reouest the unload- 
ing of a Program presently in core. If necessary It stops 
the proorams operations Including eurrent I/O. However It 
establishes conditions which permit the transient Monitor 
now brought Into core to close any files left ooen and re- 
lease all datasets still Initialized. 


Command Format* 

No arguments are needed? so the command Is simply* 

KI ILL! <CR> 


General Description* 

If a program is seen to be loaded? all I/O is, killed by a 
hardware RESET and? by a search of the Monitor DDB. chain? 
all I/O. busv states ere removed. At the seme time? if eny 
linked file Is still open for outout? a final block with a 0 
link ia preoared for later dlspeteh when the transient Moni- 
tor calls CLOSE, (see Section 4.1) 

The eetual kill Is effected bv e .EXIT. call, (see Section 
6*5) end? of course? the Special Driver Is net reeelled. 
Henee. thecommand processor ensures that the MSP needed by 
XIT is free and reinitializes the keyboard Listeners ppm 
Inters, Finally to allow XIT ample room and drevent possi- 
ble failure? the stack is set et the too of available memory 
before the FmT 60 cell ia made. 


Exit State* 

If the KILL command Is accepted? eurrent Register end stack 
states eease to be relevant. However If no program Is load- 
ed? the Soeelal Driver is recalled to reject, the command. 
In this ease? the reouirementa noted in Section S.2.8 aoely 
and In particular R1 is set to -2 to reouest an "Invalid 
Command" message. 
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Detailed Processing; 

KILL Processing taxes the following sequence; no illustra- 
tion la needed, 

1, Restore Registers passed bv the Intenpeter and re- 
move Its return parameters from the staek, Reject 
the command as Invalid through the Special Driver 
if the muS in the 3VT (aee Section 2.1,1) contains 
a low bvte of • oroqram not loaded. 

2, Wait for the console printer to complete Its outout 
of the command LF (see Section 6,1,2), Kill all 
I/O by RESET# but restart the llne-eloek If present 
(as shown by its Interrupt veetor pointing else* 
where than the trap error routine (see Chapter 7)), 

3, Set the start of the Monitor DOB chain from the SVT 
(see Section 3,1, 2,3), Go to step 9 If no DDBs ere 
currently established; otherwise for eeeh DDB In 
the chain# clear, its Busv Flag and that for any 
driver asloned to it and remove any Q linkage (see 
Section 3,1,2,4) 

4, If# after examination of Its Facility Indicator 
(see Section 3.3,1)# anv driver Is seen to.be 
f 1 1 e-st ructured# cheek for. a file still open for 
output. If sueh file Is linked and apparently cor- 
rectly underway# dear the link-word in the data 
buffer attached to the relevant DDB and set a vari- 
able pointer In the PDB Driver. Word Count to Indi- 
cate that data still remains for output when later 
elesed. 

3, After all the DDBs have been processed# remove the 
Usage-Count and Oecupant-Ident 1 f ler from the start 
of the MSB to release it for further use (see Sec- 
tion 2,3, 1) 

6. Remove the Seeds! Driver reeall parameters from 
the staek and use the saved Listener Pointer Store 
address now on top (see section 6.3.1) to relnl- 
tial ice the Listener. 

7, Move the staek pointer to the toe of eore (below 
the possible Paper-tape Svstem Loaders) end esll 
•EXIT to feteh the transient Monitor to Perform 
oost-prooram elean-ur. 
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6.4.7 The TIME Command. (K8I.TI) 

In Section 2.1.4. it was shown that If a 11ne?e1oek Is pre- 
sent In a DOS eonf lourat 1 on, the Monitor initialisation rou- 
tine automat 1 eel 1 v seta It into ooeratlon by enabling Its 
Interrupt facility? Section 2,5 then outlined the resident 
Monitor module which usee each interrupt to Increment e dou- 
bl e-pree 1 s 1 on counter stored as TOD in the 8VT. .The TIME 
command exists so that the operator can enter a. daily ini* 
tial aettino for Too and can later interrogate its content. 


Commend Format! 

The general form for the command la as fellowsl 

TICME1 fHM|MMiSS]<Cb> 

bhere HH, mm end S3 each reereaent up to two decimal digits 
for hours, minutes and seconds. 

As with the DATE commend, discussed In Section^ 9.4.1, the 
presence of the argument identifies th# entry of a new time, 
its absence a request for print-out In the seme format. 


General Description! 

Provided that the first eharaeter of any argument In the 
command Is a valid decimal dial?, the TIME Processor assumes 
TQD Input and converts eaeh decimal ASCII element, into its 
binary equivalent. If each value Is then within itf expect- 
ed limit. It is reduced to eleek-tieks after effective mul- 
tiplication by an aeproorate factor. The sum of the three 
results Is stored In the SVT Time slot In the. defined 
doubl f-oreeislon format, l.a. with eaeh. word consisting of 
a positive (0) slqn followed by 15 numeric bits. If anv 
element is omitted, a default value of 0 Is substituted 
(e.o. "TI 12" Is aecepteble In lieu of "TI 121010")! 
however, sny_other departure from the specified format causes 
rejection of the eommend on the grounds of "Illegal Syntax", 

TOD print-out Is supplied ss e result of there being no com- 
mand argument or of one beginning with a non-digit. The 
current content of the SVT Time counter Is successively di- 
vided by an appropriate value to produce the reoulred ASCII 
digits which ere then diaoatched to the console printer with 
seosretino colons and a terminating CP/LF, 
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Exit State! 

Regardless of the processing performed# the TIME routine re- 
turns to the Interrupted orogran by Soeelal Orlver recall. 
Hence the Register and stack state ere as detailed In See* 
tion 6.2.5# If In fact the command Is releeted because of 
Faultv Syntax# PI contains -3. 


Detailed Processing! 

Both (he incut and output functions use. slmUi# .successive 
addition end subtrsetlon algorithms for multiplication end 
division. The processing sequence therefore Is as Ulus* 
trsted at Figure 6-10 and Is basically as follows! 

1, Restore Registers passed by the Interpreter end 
clear return paramet ers fro* the stack,. If the 
first character of any argument is not a decimal 
dlolt# assume output Is reoulred end go to step 7, 

?, Clear a double-word store on the staek and set a 
oeinter to a table of alternate element limits 
(l.e. 24 hours# ,60 minutes# 60 seconds) and cor- 

responding multlol icetlon factors, 

3, Using the standard "Multiply previous result bv 1 9 
and add new dlolt" technique# convert consecutive 
decimal digits to binary (single-ereeision only 
needed)# stopping at the first non-digit. If ths 
resulting value exceeds the exoeeted limit# recall 
the Special Driver to reJeet the command with 
"Faulty Syntax" print, 

4, Use a non-0 incut value as e counter while adding 
the current multiplication factor into the store on 
the staek (allewinq for the 0 slon In the low-order 
word) , 

3, If the "Seconds" factor has Just been used or the 
end of the araument has been reached# go to stee 6 
to. store the result. Otherwise check the character 
which stooped the conversion In ateo 3, Treat 
spaee at the. end of incut and again oo to ateo 6, 
For colon move to next table entry and repeat from 
step 3, In all other eases# reJeet the command for 
"Faulty Syntax", 

6. Move the final result from the stack into TOO In 
the SVT and recall the Soeelal Driver, 

7, For orlnt-out# collect the current TOD content and 
adjust it to remove the low-order sign. Set a oo- 
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inter to a tabl# of reduction factors for eaeh de- 
cimal dlolt of the outout, 

6, Starting fro* tha ASCII digit baaa(6S), count the 
number of successful subtractions of tha current 
table factor. Restore the remainder when negative 
and move to next factor, 

9, Send the resulting character to < the console 
printer, If the first dlolt of a pair, repeat fro* 
step 8. If the second but not that fon the "Sec- 
onds" element* print eolon and then reoeat from 
step 8, 

18, Otherwise restore the printer carriage with CR/IF 
and recall the Special Driver, 


6 ,4,6 Th e Hqqif y Co m mend ( K B T , *Q ) 

The MODIFY command Permits keyboard simulation of the Fxam- 
Ine pnd Deposit panel switches for making minor changes to 
locations In normal memory at any time. At each reouest* 
the content of a specified address Is output at the console 
printer. The user mav then merely close the location bv en- 
try of CR slone or he can type In seme new content first, 
Replacing the.CR by Lf results in. the Automatic outout of 
the content of the nest location for similar action and thus 
provides for seauentlal examination and modification. 
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This of. eoufit fs the same teehnfoua as that used In 
00T-11R. However ft fa not Intended that the MOOJFY eo-nand 
ba a substitute for that program In normal dehueginei ft fa 
Just a means for making known oatehes to an already tested 
preeram aa a tamoorarv measure# until tha orfofnal sourea 
can ba eorraetad and reassembled, Tha commands provisions 
do not therefore extend to ooaratfons uoon tha contacts of 
Registers or tha external page. For tha latter eaaa espe- 
cially# tha. commands oroeassor has no way of ehaekfng ad* 
drese- 1 egal i tvt ft could only try to aeeass a reoufred lees* 
tfon and trust that no hardwara trao foHowad, As shewn fn 
Chapter 7# such trap would result fn a call for Error Ofeg- 
noatfe printing which also needs the KsBt sfnea thfs fs net 
free and tha MODIFY eroeessfna cannot ba continued to make 
ft so# the system would hano, Hanea the command fsrajaetad 
unless .the address can be varfffad as befno within normal 
bounds ( 1 ), 


Command Fermat i 

Tha MODIFY command must Include an argument! thus Its format 
Initially fat 

MO [DIFYl Octal addreas <CP> 

where tha address lfee on a word-boundary within available 
memory (leading tares not reaulred). 


General Description! 

Provided that. tha address fs valid as noted above# tha modi* 
FY processor internally converts its oetal ASCII dlolts Into 
a binary value which Is than used to sat a pointer. 
Thereafter the oeerat1on_1s a dialogue eonslytino of one or 
aeveral lines# for each of which tha Processor first orfnts 
the following* again usino Its own octal translator! 

Address/Content ! 


1. The hano*up can nevertheless occur if* by the LF pro- 
cess# the user staes above the available memory limit. 
Owing to tha limited paeaefty of the K 3 B# tha legality eheek 
is made onlv on the first address opened. Hence in the Pro- 
grammers Handbook# the user fs advised to be careful. 
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and waits for the usar reply (D# The characters entered by 
the operator are atoned on toe of the command in the Lis- 
tener* bufffr# and during this period# RUBOUT or CTRL/U are 
assumed, to indicate erasure of oravlous Ineut as In th* ori- 
ginal conmsnd. The Input stops at the first CR or LF when 
valid ©et*l Input# if any# is used to reset the content of 
the address under th* pointer# A LF entry continues the di- 
alogue?, CR eausas an exit to the interrupted program by Soa- 
eial Driver recall# 

An invalid address In the command or Illegal characters In 
the octal content entered stop further action on the command 
with an aopreerlate message being printed aaain through the 
Special Driver, 


Exit Statet 

As shewn above# the eventual raturn to the program i* always 
through the Special Driven henee Register and staek stata 
are eoveredbv Section 6#2#5# On error exit# Ri may contain 
one of the following! 

•3 ■ Illegal characters during input# so 
Faulty Syntax 

-6 e Illegal address • not on word-bound 
In available cor* 


Detailed Processing! 

The sequencg of operations in MODIFY processing Is Illus- 
trated at Figure 6*11 and Its outline is as follows! 

1. Restore Registers passed by, the Interpreter end 
dear its return parameters from the stack. 

2. Convert anv valid octal ASCII Input into binary and 
store as a memory-aeeess pointer# Releet the com- 
mend through th* Soeelal Driver for "Faulty Syntax" 
for no argument# for on* containing characters oth- 
er, than octal ASCII digits or for single-word over- 
flow# Also exit# If th* converted value Is an 
"Illegal Address" as soeelfled above. 


1# Th* Interrupt facility eannot of Course be used since 
this requires th* reloading of the Specie! Driver- an Impos- 
sible, ooerat Ion while the MODIFY module Is still, reoulred# 
The innut Is therefor* controlled by flag testing and the 
eharaeter-handl 1 no processes are embedded# 
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3, Co«v«ft the counter content to Its ecrresoendl no 
ASCII digits end dispatch to the eO*se1e Printer 
followed bv e /, Likewise# Process the content of 
the address under the pointer, terminated bv e l 

4, Using the position of the command terminator In the 
Listeners command buffer* set pointers for the user 
reolv* (There Is still ample room since the buffer 
een aceeot e full line ■ see Section 6, 3,1), 

5, We.1t for the 1nput.ee noted under "General Descrip- 
tion" and when available store the ehereeter* with- 
out parity (bit 7)* in the bvte et the start of thw 
new string (to utilize the seme teehniauea as In 
the original driver (see Section 6,3.2)) 

6, If the entry Is CTRL/U* eeho aU» and restart from 
step 4 (note no CR/LE in this easel) 

7, Cheek whether a RU80UT Is psrt of a seoutnee (next 
Inout byte ■ 200 • see step 5 above). If not* echo 
as P before printing the ehereeter deleted (If eny 
nenelnlng). Set the switeh for the next input end 
reseat from step 5, 
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8. Store anv other charset ar in the input buffer (fol- 
lowed by a as a "no RUPO'iT" flap), Tf the previous 
character waa RU80UT, echo Of if the new one is not 
a terminator (-basically CP op LF) (1), merely echo 
it alao and reoeat from step 5, 

0, For any terminator, print CR/L.F, If any other in- 
out has occurred (includino 0), convert valid octal 
ASCII dioita into a binary value ( 2 ) and store this 
in. the address under the Dointer in place of the 
original content. 

10* If LF was entered, increment the memorv-aeeess co- 
in t e r and repeat from step 3, Otherwise exit 
through the Special Driver, 

The method used to control the octal conversions deserves 
mention here. The seouenee for any dialogue een be simoly 
considered ast 

1, Convert octal inout to binary - initially the com- 
mand argument 

2, Convert binary address to octal and print 

3, Convert binary content to ©eta! and print 


1, The eheek method used in fact allows any CTRL eheraeter 
with .an ASCII value less. than CR (019) to act as a termina- 
tor with all but LF stopping the MODIFY seouenee, Henee 
CTRL/C entered at this time has no other effeetl to issue a 
new command with a Program running, a aeeend CTRL/C is thus 
necessary , 


2, A subroutine used in step 2 is also called here. This 
may have two eonseauencest 

a. The error conditions leading to command rejection 
by Special Driver recall again have this effect, 

b. Space is acceptable in lieu of CR at the end of the 
commend argument to allow separation of comment 
preceded by t. Since recoanition of spaee there- 
fore stops the conversion validlv, it is possible 
to enter comment after replacement content, or 
instead of it. However, as implied at step 4, the 
user must take case as the buffer is now less than 
line-size and no cheeking oceursi 
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4. Return to 1 to convert new octal content and looo. 

To aaya on the restricted capacity of the KSB» the two su- 
broutine* ate In feet aet uo aa a co-routine of the main se- 
quence » using a similar teehnloue to that described for the 
.READ^.WRITE oroeessor in Section 3.2. 2*2. 


6,4.9 The ASSIGN Command (*BI,A8) 

In Chapter 3, It was shown that the. Monitor allows the user 
to leave until program run-tl-e his final selection of the 
I/O devices and files to ha associated with the datasets 
servicing the prooram. Section 3,1,2. 2* in particular, des- 
cribed the table which ean be set up within the Monitor area 
to contain the necessary assignment Information used bv the 
. JNIT processor (see Section 3,2,1. 1) and the 
Mla-manaoamant subroutine LU* (see Section 4.4,1) when pre- 
paring for I/O operations. The ASSIGN command Is provided 
principally as the means whereby this table is established. 
In this resoeet* it ean be entered at any time* though with 
different, effect depending upon the system state. Moreover 
as noted in Section 3. 1.2.2, it Is of value only jf.the run- 
ning program has not yet completed Its data-set initial 1*e- 
tjon. The command may also be used to clear outstanding as- 
signments# but only If no program is loaded. 


Command Formats 

The general form of the command Is as follows* 

ASTSIGNl [Dataset Specifier* Logical Name)<CR> 

where "Logical Name" is the thpee-choracter identifier for 
the relevant dataset as shown In the Program Llnk-bloek (see 
Section 3. 1,2.1) and "Dataset Specifier" mav consist of Dav- 
ies name and unit *, Filename end extension and UIC (but no 
switches)* exaetlv as defined for C$1 (see Section 0,4) and 
obevlng the same rules for el ement-oml ss Ion. (1) 

The presence of the argument etrlng Implies a new antey Into 
the Devlee Assignment Table (DAT) and as Indicated sueh 
string must Include at least one acceptable element for 
data-set specifier and tha looleal name. No default assump- 
tions are made) these ere expected to come from the program 
Itself. 


1, Because of its delimiting function In the command 
language# "space" Is of course not similarly ignored. 
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If no argument fa given, the command alqnfffea that any ex» 
fating table fa to be removed, Thle form fa meanfngful and 
fa therefore acceptable only when no program fa loaded, 
(aee Seetfon 3, 1,2, 2) 


General Deoerlptfon* 

Aa noted above, the ASSIGN commend permfte deteaet specifi- 
cation fn CSI format* However fta preeeaaor eannot uae CSI 
• 1 nee„there,nay be e running program already uefng the MSB, 
Therefore ft muat, ea mentfonad earlier, provide fta own 
cheekfno end decoding ea well ea making the appropriate OAT 
entry. Thfa operation needa three overleyat 

1, Syntax Anelyaer - acana the argument etrfne for ae- 
eureey fn accordance with CSI rules. and preoarea a 
table on top of the ataek which lfeta the string 
at art eddreaaea for each of the potential elements. 
At the aeme time, valid eharaetere for elementa to 
be Peeked fn radlx-30 format ere reolaeed fn the 
atrfng bv thefr eor reaeond! no eonverafon eodea (aee 
Seetfon 5,3), 

2, Decoder - tranalatea each atrfng element Into the 
OAT format using ftp own redlx-50 and petal ASCII 
eonverafon routines* The results are atered fn the 
table on the ataek Instead of the atert eddreaaea, 

3, OAT-entrv Routine - reduces the teble on the ataek 
to Its OAT entrv form ea Illustrated fn Figure 3-3 
end adds. ft to any existing OAT (removing any other 
entry of the aeme logical name) or Initiates a new 
table ff none presently. 

If no. argument fa entered, the ffrat overlay passes control 
Immediately to the third and provided that no program ex* 
fata, any current OAT fa removed by the return of fta area 
to free core. 


Ex f t State* 

In all gases, , cont rol fa returned to the Interrupted atate 
bv Special Driver reeall, thua again Registers and ataek are 
aa deacrfbed In Section 6.2.5. Errora In the Input argument 
ae uaual eeuee rejection of the command with the appropriate 
measaoa, for whfeh R1 fa aet aa follows* 

-2 ■ Program fa loaded eo nul 1 -argument 
command Invalid, 

-3 ■ Faulty Syntax (Illegal eheraetera or 
elementa) 
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• 7 ■ No. buffer space for a new assignment 
while a program 4a underway. 


Detailed Processing* 

Tha overel 1 sequence of operations performed by the ASSIGN 
command 4a illustrated at Figure 6-12, As indicated under 
"General Description"# th4a 4a covered by three overlays 
wh 1 eh ara . 4 nd4 vldual 1 v dlseuased below, In each ease# tha 
first task 4a tha restoration of Register contents saved by 
the eall end tha removal of tha call return parameters from 
tha staek. 

Tha Svntex Analvsar Overlay 4a loaded bv tha Interpreter 
eall, It takas tha following eteost 

1, Clear a table on too of tha ataek for uae aa dep- 
icted In Flours 6-13, If the command has no argu- 
ment# exit to eall overlay #3, 

2, Sean. the argument for ! whieh earn only mean dev4ee 
apse 4 f 4 cat 1 on In .this ease (no switches# hones no 
yeluos), If none 4s found# go to steo 3 to look 
for Filename or UIC, Otherwise tha first eharaeter 
of tha argument must be a latter, since deylee 
name# bv definition# Is alphabetic only. Provided 
that sueh is the ease# store the start address of 
the argument In the stack-table slot for "Davies" 
and translate up to three letters^ into their 
radix-53 eode within tha eommand buffer. Assume 
that the next eharaeter not being the l signifies 
tha start of a unit number and store Its address In 
the staek-table "Unit," If the eharaeter after the 
t la seaee or eomma eo to step 5 to eheek for logi- 
cal name, 

3, For a non-el ehabet i e next eharaeter - or first If 

no davlee • oo to step 4, Store the address of a 
letter as the start of "File-name" In the 

stack-table and again translate it and up to five 
subeeauent letters or digits into radix-50 eode In 
the buffer. If the next eharaeter Is then ,# repe- 
at the process for up to three letter? or digits 
more# storing their start as "Extension", on re- 
cognition of soaee or eomma at anv point# go to 
step 5 to handle logical name. 


4, Save the address of a T as the start o* a .UIC and 
scan for ] when found go to step 5* provided that 
the next eharaeter Is spaee or comma. 
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5, Store the address of the first character after a 
space or eomma In the steekataMe as the start of 
"Logical Name" and translate the uo to 3 characters 
into their Pedlx-50 format as previously# provided 
that thev are letters or digits* Call overlay #2 
from the next block on the system*deviee when com* 
elate* 

6, If one of the following conditions is encountered 
during the processing so far described, reject the 
command for "Faultv Syntax" through an immadlata 
Special Driver recall (with the pointer table 
scrapped) I 

a. An argument beginning with a character other 
than e letter or f (Including seaee or eomma 

sines there must be at least one dataset ele- 

ment). 

b* An argument terminating before a space or eomma 
followed by et least one letter or digit of 
looleal name* 

e, Exeess characters in Filename or Extension, 
d* ( not followed bv 1 * 

At the exit to overlay #2# the table on the ateek now con* 

tains the addresses In the buffer storing the elements spec* 

ifled in the Input* Omitted elements are Identified by a 
slot Still sat at the original P from step 1 in the previous 
paragraph* The overlay Is now responsible for coding the 
elements as follows! 

1, Set pointers to the start of the tableen the staek 
and to a eorrespondl ng table of conversion 
subroutine despatch addresses (actually relative 
eff-seta to allow for PIC), At the seme time, save 
tho end address of the valid Input string to delim- 
it logical name - see below, next step. 

2. Collect the element start address, Tf 0, bump the 
table pointers and trv again* Otherwise scan up 
the steck table for the next non-0 entry to fix an 
end point for the current conversion (allowing for 
an expected terminating character, i*e* t after 
devlee, *, after filename etc*) 
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3, Set a standard eount for a three-chaneeter conver- 
sion and oo.to the appropriate sub-routine as fol- 
lows, returnino whan either tha and point is re* 
aehad or tha count runs out (1)» 

a, Device name • adlust the and point deoendino 
upon tha nest included element (sines no punc- 
tuation mark oeeura between devie® name and un- 
it wheraas there are two between device and 'JIC 
(if) or looieal nama (it), Peek three char- 
acters (or aetual number with trailing aoaees 
to force left Justification if need be) into a 
Pedix-50 word and sat into the staek table. 

b. Device unit - also allow double punctuation if 
no file-entrv, Convert up to three valid oetel 
digits into a single bvta and store. If any 
other character oeeura before the end-point is 
reached or if the bvte overflows, clear the 
sub-routine address table pointer as an error 
flag. 

e. File name (word 1) - radix-50 pack three char- 
acters (aoain with foreed trailina spaces) and 
store in the ataek table. Sava the start ad- 
dress of the next three characters in the sec- 
ond Filename slot in the table. 

d, File name (word 2) - similarly Perform radix-50 
oaek and store. 

e, Extension - likewise. 

f, UIC • adjust the end point for double punctua- 
tion ()») and convert up to these valid petal 
dibits into a single bvte as <5rouo Identifier 
(sea Section 4.1.4). Provided that the next 
character is a eomma, reDeat for User Identif- 
ier, In addition to errors noted under "Unitp" 
set the flag for a non-comma separator or if 
either conversion produces 0 or 177 (the letter 
being reserved for * under CSI), 

4, If the subroutine address table pointer is still 
set upon return from a conversion, repeat from steo 


1, Eaeh subroutine in feet cells one of two eo-mon conver- 
sion routines, one to pack characters in radix-50 format, 
the othpr to form a binarv word from octal ASCII dibits. 
These in their turn are eo-routinea with a ainole byte pro- 
cessor jn much the same way as that, described for the 
Conversion Utilities Package • see Section 5,3, 
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2. Otherwise scrub the stack-table end recell the 
Special Driver to reject the command for "Faulty 
Syntax" . 

5, On completion of ell the routines In steo 3# 
redlx-53 Deck the logleel nsme (also left Justi- 
fled) end cell overlev #3, 

Thus on exit to overlay #3# the steek tsble now eontelns the 
ectuel entries for the DAT proper. However there mev still 
be some orlolnel 9-slots for items unspecified. As shown In 
the DAT Illustration et Floure 3-3# the fine! form msy be 
contracted, _ This Is done on the steek before the move Into 
the DAT as follows! 

1, Set up relevant pointers. If the staek-toe (Logi- 
cal Nsme slot) Is 0 - impossible unless there is no 
eroument et all • oo to step 19 to remove the DAT, 

2, Set a full count (4) In the "# of words to follow" 
byte of the "Unit" word. Decrement the eount end 
move the Logleel Name entrv down the stack until 
the first non-0 table entry Is seen# stepping at 
"Unit". 

3, Collect the content of BAT In the 3VT (the DAT oo- 
Inter - see Sjetlon 2,1,1), If It is non-0# a 
table already exists# hence go to steo 9 to find 
its end. Otherwise eheek the MUS in the 3VT. If 
its hloh bvte is 1 (program loaded end running) or 
-1 (program loaded end started but new suspended)# 
oo to steo 8 ss a buffer must be claimed from free 
eore (see esse 3 In Section 3, 1,2,2). 

4, w<th no Program underway# collect E0« from the SVT 
and adjust for the two reserved DAT link words • 
see Sections 2.1.4 and 5.1. Leave one as s switch 
however If a program Is leaded without additional 
Monitor routines (see esse 2 in Section 3,1, 2,2), 
Store the result in BAT snd go to steo 9 to set up 
the entrv, 

9, Search for the end of an existing DAT ss follows 
(see also Floure 3-2)1 

a. If the first word of an entry Is -1# identify- 
ing the end of a OAT segment# collect the next 
word as the start of a new segment. Try aoeln# 
unless his next word Is 0 meaning the end Is 
new reached, 

b. Check whether the dataset named in the_ command 
Is the same as thet for the entry. If so# re- 
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Place the entry by a link to the next C-l# ad- 
dress" aeouenee) .- thua erasing the entry* In 
ease the new snee 1 f 1 cat 1 on Is larger than the 
©rlqlnal . 

e, Peoeat fro* (a) for the next entry If this does 
not start with P, whleh also signifies the DAT 
end. 

6. If the D*T end Is a -1*0 seauenee (caused by a BE- 
GIN unlinking assignments in free core buffers • 
see Section 6,4.5) remove the -1. 

7. Cheek the M(jS for a program underway as in steo 3. 
If none* go to step 9 to transfer the new entry# 
erovidlng a link to the current EOH if this does 
not coincide with the DAT end (owing to the feet 
that the orevlous entries were made before e pro- 
gram was loaded and now additional Monitor routines 
have been made resident). 

8, When a program Is underway# request a 16-word 
buffer unit from free eore through the Monitor 
S.GTB routine (see Section 2.4.2). For a first as- 
signment# store, the buffer start address at BATf 
for anv other# lin(s the buffer to the current DAT 
end. (if no, buffer is available# however# reeall 
the Special Driver to tell the operator.) 

9, Transfer the Logical Name from the new specifica- 
tion into the DAT followed bv the other items and 
two reserved Link-words of 0. Adjust the EOM, TOB 
and Its staek-stoo (see Section 2.4.1)# If no pro- 
gram Is underway. Exit through the Special Driver. 

16. Aeceet a command without argument only when no pro- 
gram Is loaded. In this ease# save the DAT start 
as the new EDM, clear BAT and exit through step 7 
to reserve the 6 links and adjust the end of Moni- 
tor pointers. Reject the command as Invalid 
through the Special Driver otherwise. 


6.4,10 The DUMP Command ( K B I , 0 U ) 

The DUMP command was originally Intended to provide. a means 
for trensferrlno eore Images to or from any appropriate per- 
ipheral device at any time# regardless of the present system 
state - as opposed to the load Images obtained through SAVE 
with the system necessarily Idle, However for the following 
reasons# its current implementation Is limited* 
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1, Paoer-taoe requires some form of fomattine to en- 
sure. date*eecur*ev, Thus a DUMP 1* this ease of* 
feetivelv eoeies tha SAVE facility auPol emented bv 
PUN or GET and Is not therefore considered entirely 
worthwhile merely to allow occasional usage while a 
program is running. 

2, Normal usage of bulk-storaoe devices acquires the 
help of the P1 1 e*management routines whleh een only 
be guaranteed if no Program la underway to need the 
MSB • hence the restriction on SAVE (see Section 
6.4.2). The only safe alternative la to. have a 
ore-determl ned araa reserved on each device which 
ea.n then be accessed bv simulation of .TPAn, This* 
though* raises two problems which are presently 
deemed to be too restrictive for the majority 
users. 


a. The area reserved Is lost to the user even 
though he never reouesta a DUMP. 

b. Anv dump destroys the erevious content_ of the 
reserved area and the user must therefore save 
this each time If It Is still of value. 

Hence for these devices* SAVE remains the only general pro* 
vision. On the other hand# SAVE to a Li na-oir i nter is both 
meaningless and 1 1 1 egal since bj nary operations are not per* 
mitted, Ou"P Is therefore provided In its ease only. 


Command Format* 

The full format allowed bv the DUMP command Is as fellows* 

DUEMPJ fDevIcejr, (I OP 0] t* tLONI (# HIGH] 1} 


Where* 


device ■ Standard name code and unit 
(l unnecessary) 

I or 0 ■ Dump direction (assumed 0) 

LOW ■ Dump area start address (assumed 0) 
HIGH ■ End address (top of eore assumed) 

(LOW end HIGH being octal and on word bounds within avail* 
able memory). 

It follows from the 1 nt roduet Ion, of course# $het device een 
only be LP and direction 0, However In ease It Is later In- 
cluded# the default device is that for the system. 
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General Description! 

Despite the currant restriction, the Dump command oroceaaor 
is daaianeo for generality of device, Tn order to allow us- 
aqe at anv ting, it cannot assume that a necessary driver is 
in core to service the device. Even if it is, it need not 
be readilv available for the Dump operation. Henea the rou- 
tine must have its own drivers for the ouroose, In the in- 
tares? Of possible expansion, the DUMP module is therefore 
organized as a common arau-ent decoder which performs any 
Cheekina required and conversion of the various items in the 
input and then cells an aoprooriate overlay containino the 
requisite driver. 

Currently two overlays are provided. The first is entirely 
taken yp by a driver for the Line-printer end contains the 
processing needed to produce a print-out as shown at Figure 
6-14,, This qives both the content of eaeh word in the O'JMP 
area in oetal ASCII and that of each byte as an ASCII char- 
acter* whpn modified as necessary to produce a printable 
eharaeter in the 6-bit range. It also aeeeots a CTRL/C in- 
put at.the keyboard as a signal that a DUMP underway should 
be termi nated. at the end of a current paqe, The second 
overlay Provides the hooks for the later inelusion of other 
drivers but presently recalls the Soeeial Driver immediately 
to releet the command for "Illegal Oeviee," 


Exit Statai 

The DUMP oroceaaor always returns to the interrupted orogram 
through the Special Driver? so the Register and staek state 
are as described under Section 6,2,5, Command rejection as 
usual fellows errors, indicated in R1 as follows! 

-3 ■ Faulty Syntax 

•4 ■ Oeviee eennot be used for 0U M P, so 
is Illegal 

-6 ■ An Illegal address Specified is net 
on a word-houndard within available 
core or low is not leas than high. 

Detailed Processing! 

Figure 6-15 illustrates the sequence of operations in the 
DUMP processor. As noted under "General Processing", over- 
laying oceu"s. The segments concerned are outlined in the 
following peragraohs. 

The segment ealled by the Interpreter decodes the argument 
and then eells the appropriate driver overlay as under* 
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1. Restore Register contents oessed bv the Interpreter 
end clean its return parameters* Preoare a 
four-word table on the staek for usa as element 
storage after conversion! 

•SPf END ADDRESS 

START ADDRESS 
DEVICE NAME 

DEVICE UNIT/TRANSFER DIRECTION (flaOMel) 

2. Radix-53 pack leadino letters from_ the argument 
string until stopped either bv a defined delimiter 
(soaee, comma or CR) or by a non-al pwabet 1 e value* 
Store the result In the stack-table "Device" slot, 

3. If the radix conversion ends with a non-al ohabet 1 e 
character, allow for a single oetal ASCII digit as 
unit (DUNPIno is never evpeeted to be a facility on 
devleea havlno more than eight units to a single 
controller). Store on the etaek If found. Ignore 
f but reJeet the command for "Faulty Syntax" bv 
Special Driver recall for any other eharaeter(s) 
before the first delimiter* 

A, Accept one character before the second delimiter. 
If it is I# Increment t he 0 . "Transfer Direction" 
byte In the stack-table* (No increment eeeurs for 
anv other Input, thus forcing 0), Again reJeet as 
"Faulty Syntax" for more than one character, 

5* Convert valid oetal ASCII digits up to the next 

delimiter end store as LOW limit, provided that no 
overflow of a single binary word occurs* Then re- 
peat for HIGH limit, (In this ease "Faulty Syntax" 
means invalid innut or overflow), 

6, Check that both limits are on word-bounder ies with- 

in available memory and that the LOW value la leas 
than HIGH (replaced by top of core if none en- 

tered). This time reJeet the commend for address 
i 1 1 eoal 1 ty. 

7, Replace the HIGH limit bv the appropriate number of 

words to be DUMPed (positive, value) and check 

whether a devlee has bean specified* If none, re- 

place with the. name of the svstem-devlee as shown 
in the DDL (Section ?*1*3). 

8, Seareh a table of potential devices for the DUMP 

and call overlay. *2 1 f LP la resulted or S3 for 

other possibly valid specifications* Reject the 
command for "Illegal Device" otherwise. 
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If either of the overlays is eallad the Decoder exits with 
the ateek-table eleered and its content sst in Registers as 
f ol 1 ows i 


Rt ■ Start of the DUMP area. 

R2 » * ef words to be dumeed, 

R3 ■ Positive code for a valid device# 
based on table-position $LP«0) 

R5 ■ Unit and Transfer Direction, 

Thus# the aooroeriate parameters for a DUMP are received by 

the overlay on the staek as saved by the E M T Handler (see 

Section 2.2.1), 

The Line-orinter dump has a basic format in wkieh each eaqe 
eovers 1000(oetal) locations divided into a blocks of 
100(oeta1) locations. Faeh bloek is Printed as four lines 

of B words in oetal ASCII followed by 16 ASCII bytes. The 

overlay is set uo to control this format as follows! 

1. Restore Register eontents passed by the decoder and 
remove its return parameters from the stack. If 
Output is not the direction specified# recall the 
Special Driver immediately to reject the command 
for "Illegal Device," 

2. Save the current value of the stack oointer in the 
SVT word reserved for the purpose (3VTa32 - see 
Section 2.1,1) so that it also may appear on the 
DUMP if required. (1) 

3. Save the DUMP area start soeeified and adjust an 
access pointer to commence printing from the toe of 
a full page# i.e. from the Previous location end* 
ino in ...000, Print FF to start a new oaaa. 


4. Print the address of the location starting a block 
(always ends ,.,.00) followed by LF, 

5. Start a detail line with the last two dioits of the 
first address on the line (e.g. 30# 20# 40, 90) 
preceded bv space and followed by !, 


1. Since the proaram Registers are saved on the staek at 
this point# these ean also be examined on an aperopriate 
DUMP, The saved SP points at the address of the console ty- 
pewriter buffer (saved R4 for the Soeeial Driver Recall) 
whieh is then followed by the return Parameters for the re- 
call - see Figure 6-2 for further detail. 
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6, If the access counter has not vet reached the saved 
actual start# print seven soaces. Otherwise outout 
in oetal A8CTI the content of the location under 
the pointer. (6 dioita) preceded bv one soaee. 
Reoeat for eight locations in all unless the Word 
Count specified runs out. In this case again oad 
the rest of the line with spaeee, 

7, Print a terminal t and soaee. Reset the aceess po- 
inter to the beoinnino of the line and set another 
to the last valid byte to be printed. As with 
words in step 6# print spaces for each byte in the 
line prior to the actual DUMP area. Otherwise eon- 
vert eaeh byte stripped of bit 7 into a 6-bit ASCII 
value on the following basis and print until the 
1 i ne-end. 

7 Bit value! 000-037 040-137 140-177 
6 Bit value! 100-137 040-137 040-077 

8, If the end of the DU M P is not yet reached# orint 
LF. Return to step 5 unless the aceess pointer 
ends in ....00, indicating the end of a block. In 
this ease# orint a seeond L.F to give a gap between 
blocks and return to ate» 4 if the block dees not 
also end a page (pel nter*. • • • 00) . For the latter 
situation# replace the second LF bv FF and return 
to step 4 provided that no CTRL/C has been struck 
at the Keyboard, 

9, Terminate the DUMP listing with FF and return to 
the interrupted program throuph the Special Driver, 

It should be noted that any hardware failure at the printer 
which eauses an error report will stop the DUMP with an 
"Illegal Device" message. If the printer is not a valid 
device on the system# by normal hardware trapping a fatal 
error message will be demanded and will result in hanainq 

the system owing to the conflict in KSR usage# noted in 

Chaoter 7. (Monitor reboot is neeessarv if this happens, 1 

As shown under "General Dose r i ot i on" # the second overlay at 
present merely deans up the staek end reports the deviee as 
i 1 legal . H9wever# should extra devices be added to the DUMP 
facility# it is envisaged that the following provisions may 
be useful ! 

a. The driver required ean be identified by the 

eode in R3 on entry (after Register restora- 
tion! and the validity of direction ean be 

checked in R5, 



00S6,BN« 


PAGE t 71 


b. By saving ?P In the SyT on outoutr and peatop- 
i no It on i nout • opogpam might be automatical- 
ly pesumed fpom a oolnt of dumol*g by the nop- 
mal Keyhoapd Command exit ppoeess (opovlded of 
eoupse that enouoh cope la DUMPed.) 

e« The dplvep Itself must opovlde any neeaaaapy 
fopmatting of the DUlp, 


6.5 Botween-proqpam 6 opvI cea 


The ppevloua sections of thla ChaoteP have deaeribed the 
methods used to execute Keyboapd Commands whleh may be an- 
taped bv the opepatop at tlmea when a ueep opogpam elthep 
ean op muat be loaded. It haa been ahown that in ondep to 
peaoeet that ppoqpama potential uaaoe of the system, the 
command opoceaaopa ana obliged to paatflet theip ooePatlona 
to thf eonfinaa of tha K8B» avan opovldinq theip own utility 
funetiona pathap than use thoae alnaadv contained elaewhepe 
In the Honltop. Howevep it aeema unpeaaonable that the aame 
limitations ahould alao ba extended to the handling of eom- 
manda whleh by thalp natupe Imply that thepa ean be no ppo- 
gpam _ln mgmopy whan they a.pe. given and henee the whole of 
tha avatem la aelalv at tha Monitopa disposal. Fop thla si- 
tuation thapafopa a apodal tpanalant Monltop aeetlon be- 
comaa the "ueep onogpam" - able to uae all the nopmal feell- 
Idea available but alao dpivileged In Ita aeeaaa. 

Thla tpenaient Monltop la the aublaet of this Section, In 
the flpat placer Section 6.5,1 dlaeuaeee Ita paapona 1 bl 1 !• 
ties to the avatem and deacplbea Ita ganepal atpuctupa to 
satisfy. theaa. Section 6.5,? than examinee the commands 
whleh ana ppoeesaed undep Its aegis. 


6. 5.1 The Transient “on! t on ( TMON) 

As noted in Sections ?,1,4 and 5,5, the tpanaient Monltop 
aeetlon la bpouoht Into cope immediately after* the initial!* 
zation opocaaa followlno a Monltop boot op as a Pesult of 
the unloading of a ppoopam through a .EXIT op console KILL. 
It la. then Peaponalble fop satisfying the following func- 
tional 

1. Clean-uo aftep the vaeatlna erogpam. If anv 

2. <*pepapation fop the loading of the next opogpam 
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3, Acceptance of anv operator Instruction* from the 
eonaol e 

4, Actual processing of commands restricted to the un- 
1 oaded-memorv situation and not therefore already 
covered by the normal language (currently! LOGIN, 
PUN/GET , FINISH) 


Calling Seouencei 

.EXIT »EMTe60 


OP 


AC KILL 

Section 5.5 showed that THON is read Into the too of avail- 
able memory bv the .EXIT processor, directly eeeesslno the 
Honjtor Library on the system-device, end 1$ started autg<» 
matlcaUv on successful loading. At this time* the staek Is 
cleared to its load point and the only relevant register 
content 1st 


*5 a Address of the start of the Monitor 
ODB chain COCO In the SVT - see 
Section 2,1,1) 


General Description! 

As indicated in the Proorammers Handbook, neither .EXIT nor 
a console KILL require that a running program should be da* 
tacked from any existing I/O eomml tment . It is therefor* 
the Monitors task to ensure that, in general, any outstand- 
ing output, still remaining In Its Internal buffers Is dis- 
patched to the appropriate devlee and. In particular, any 
files still ooen are closed. This cannot be don*_ by XIT 
since than the MSB is not available for the us* of the I/O 
processors! henee this is the first oo*r*t1on carried out by 
THON, using its own Link-block associated successively with 
*ny DDRs still extant In the Monitor chain. 

The unloaded program, of course, disappears under THON, 
However it m*y leave temporarily resident Monitor modules 
behind or perhaps device aaslonments made strletly on Its 
behalf (see eases 2 and 3 In Section 3.1.2.2). Also the ev- 
idence of Its presence certainly still exists, within the 
SVT. THON therefore removes these relies especially! 

a. The DAT Is cleared of all but the ore-load en- 
tries, If any 


D036.PN0 


PAGE t 73 


b, The MRT is restored to <t$ permanent state bv a 
,TPAN of the ooov stored on the svst em-dev 1 ee, 

e, Relevant entries In the SvT end the DDL are re- 
stored to their era-load state 

e, E0 M and TOP in th# 3VT (and the staelt-stoo • 
see Section 2,4,1) are set to reflect the new 
situation. 

This last operation poses a problem. It will be shown 
shortly that THQW performs Its I/O Just like, any other user 
prooram - Implying the use of free eon# as buffers, Py the 
normal proeeis* these are allocated space Immediately above 
EOM, However the operator m#y at this point enter soma new 
devlee assignments which can chanoe EOM (and overwrite the 
first buffers) " see Section 6,4,9, ThON* as a result* man- 
ipulates EOM. While Its datasets are now set-up or later 
cleared* an area of fnee eore Is added to the true Monitor 
top as a potential DAT Extension, EOm then being set above 
this area* the buffers are allocated or released out of 
harms, way. For normal running* EOM reverts to the true too* 
thus forcing env assignment entries Into the eonreet place, 
(see Plaun# 6-15) 
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T^e I/O a«n«ra1 1y performed bv TMON 1 a of course concerned 
again with the acceptance of keyboard commands end possible 
printer responses (In particular * since now the Mo* 1 t or Is 
always In a listening state). As a usar program, TMQN ean 
take advantage of the facilities of the full eonaole driver 
and use .READ or .WRITE - a particularly significant orae* 
ties since it then allows normal deyiee-1 ndeoendenee and 
henee gives DOS Initial Bateh-proeessi no eeoehllltlee (1). 


1. T M ON already contains odd. references to books provided 
for the originally Intended implementation of an OTHER eom» 
mand for a simple form of Bateh « but eurrentlv held in 
abeyance pendlnq the possible provision of a fuller system. 
Nevertheless TMON can still be used In a very basic way (on 
a non-file structured device at least) merely bv a console 
ASSIGN of C M D. However two points should then be noted! 

a. By the standard buffering scheme, aften a RUN or 
GET from the new device, valid data eould remain In 
TmONs buffer and be lost with it unless appropri- 
ately spaced. 

b, CTRL/C must only be used when TMON is not in con- 
trol (for the reasons olven above). 

e. Re-assignment of KB to C M D must precede the loading 
of the last batched program to forea Tmon to return 
eorreetlv set-up - It is too late when already In 
and initial 1 zed. 
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Again though there is a problem. All command must now cotta 
through. ThPN ao that Its own particular entries een ba 
trapped. This automatically occurs as long as the ooerator 
maralv types In t Ha command Itself In response to tha S out* 
put. However for compatibility with the remaining commands# 
he should be able to enter CTRL/P# either initially or to 
cancel current Inout, »» jhown In Section 6,3.1# this would 
In tha normal wav be intercepted by the Listener and the 
whole command would be handled by the Interpreter# eauslno 
rejection of the TMON commands since they are unknown exeeot 
at this time. To prevent this# therefore, THIN first Ini- 
tialises the appropriate datasets to brjnq the full driver 
Into eore. It then unlinks the Listener from the keyboard 
interrupt vector# substitutlno Its own version orovi di no di- 
rect aceess to the full drivers Interrupt servicing routine 
and specifically handling CTRL/C in Its own way (1). 

Thus all commands Initially come to TMON, Bv a table 
look-up# those which are especially appropriate are passed 
to an embedded processor for execution as detailed In the 
next seetlon. The remainder are passed through the normal 
operations described in Section 6,4. For this ourpose# TMON 
simulates an Interface to the Interpreter as shown In Sec- 
tion 9.3.2# having saved its own Registers and raised the 
prlorltv level to 4 as In the general ease. This means that 
the eommand Is accessed from the TMON buffer and that on 
completion# control Is returned throudh the Special Driver 
with the printer Iterruot enabled, (again see Seetlon 
6.3.2)., To allow the Listener to perform Its normal oolnter 
re-init.lsl nation# TMON simulates the Listeners pointer save 
operation (see Seetlon 6,3,1) and lets the Interrupt through 
(since the Printer is still linked), when cleared# T^qn re* 
Quests and awaits its next command. 

The. handling of errors detected bv the special processors is 
similarly accomplished bv a simulated recall to the Special 
Driver as described in Seetlon 6,2,4 with the interface set 
up as shown in Seetlon 6,2.5, This permits utilisation of 
the drivers error messaoea. Follow-uo aetlon is exactly the 
same as In the last paragraph - hence the original eommand 
Is ignored as usual. T M 0N eventually leaves after accep- 
tance of a valid RUN and GET (see next section) or is relo- 
aded afresh after FInTSM, 


1. CTRL/C is In fact converted to VT# since this as a stan- 
dard dflimiter forces input termination but atavs on the 
same printer line. T M 0 W can then simulate the normal echo 

asi 


aC<CR> 
. <VT> 
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Exit State: 

When TMdh passes control to one of Its embedded oroeessors# 
the relevant reaister contents are es follows! 

RS ■ Command outout Link-hloek address 
Rl ■ End address of the command Input 
R2 ■ Start address of the processor called 
R3 ■ Command input Link-bloek address 
R4 a Address of 09W in the SVT 
f see Section 2.1.1) 

R5 a Start address of the command argument 

In addition the stack-state 1st 

fSPl (Scratch oad) 

Start address of the command inout 
Listener keyboard vector link 

a (1) 

Current buffer base ■ dummy eom. 

As noted under "General Description"# the Register end stack 
state when, the Interpreter Is called complies with the re- 
quirements of that routine as detailed in Section 6.3.2. 


Detailed Processing! 

Figure 6-16 Illustrates the general processino oerformed by 
TMON, Its outline is as follows* 

1. iJsino the Monitor DDB chain# successively link each 
extent DDB to an lateral Link-bloek and examine its 
contents (se; Section 3, 1.2. 3). If the associated 
driver Is f 1 1 e-st ruetured or is magnetic tsoe ss 
shown by Its Facilities Indicator (see Section 
3.3.1)# end an apparently valid file remains oeen 
for output# eel 1 .CLPSF and .RLSF. In ell other 
eases# eall .RL3E only. (As shewn In Section 
3, 2, 1,3# this forces last buffer output on a 
non-file (but no device close action# i.e, ounch 
trailer. However to fonee acceptance on a 
file-device without the .CLOSE# the DDB "Buffer Ad- 
dress" must be cleared first). 

2, When all DOBs have been actioned# for safety# clear 
anv Interrupt fleas still enabled • though restart 
the clock If present (vector not pointing to error 


1. This eeuld be mrt Information for a non-resident 
.READ/, WRITE oroeesser see "Comments". 
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trap - see Chapter 7) 

3, Traee the hat, if anv r and unlink anv entries made 
after the last program was loaded (reset link worde 
on completion)! 

a. Whole table if it doea not atant immediately 
after th# Buffer Allocation Table (see Section 
3, 1.2. 2) - clear SVT pointer In this case 

b, Prom the end of the first segment otherwise, 

4, Adjust EOM & THB In the SVT (see Section 2,1,1) and 
the staek-stoo# leavlno DAT soaee as noted under 
"General Description", 

5, Clear the Buffer Allocation Table eomoletelv (see 
Section 2,4,2), Remove MUS, PLA# PSA# DSA and Pro- 
qrem Name from the SVT and all core eonneetlone to 
non-resident drivers fro" the DDL (see Sections 
2,1,1 and 2.1,3). 

6, Prepare a TRAN-bloek to read the MRT codv from 
block 45 on the svat em-dev 1 ee_ 1 nto the MRT area In 
eore# using the SVT addresses for the MRT and DDL 
to determine Its start address. and size. Cell .IN- 
IT and .TRAN on a dataset provided to effeet the 
t ransf er . 

7, Initialize a dataset to the console printer and 
output CR/LP to ensure earrl age-restorat Ion. Save 
the current content of the console keyboard veetor 
and link to as internal minimal Listener# as noted 
under "General Description," 

A. CaM ,INTT and .OPEN on dataset CMD# normally as- 
signed to the keyboard. Restore E0 M in the SVT to 
true Monitor top In ease an ASSIGN command is en- 
tered, (see steo 4) 

9. Print S and reouest .READ for the command Input. 
This can return with a VT terminator representing 
CTRL/C (see "General Description"). Reproduce nor- 
mal echo If so and try again. 

IP. Dtherwlse remove any comment preceded by 1 from the 
incut# and move CP uo accordingly, Repeat from 
step 9 when no Input remains. 

11, Compare the first two characters of the aetual com- 
mand Inout with a table of those for the embedded 
processors and dispatch to the approeriate routine 
if found. (see Section 6,5,2) 
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13. For commands normally Handled by <8T oerform the 
simulated entry noted under "General Description" 
as foil ows t 

a. Through the saved keyboard vector content, oet 
the address of the Listeners Pointer Store (see 
Section 6,3,1) and Indicate "Command Underway" 
state In the start bvte of the Eeho Buffer, for 
eventual Listener exit* 

b. Save significant Register contents on the staek 
and reset as reaulred by the Soeelel 
Or 1 ver/Interoreter Interface (see Section 
6*3*2). Simulate the necessary staek»state bv 
oushlno a level A orlorlty Status followed bv 
the Tmqm recall address (dene by JSR (n feet) 
to eouate to the normal Listener reeell (see 
Figure 6-2). 

c. Set the orlorlty level now to 4 and eall the 
Interoreter (Section 6*3*3) 

13, On return through the Soeclal Driver, save the re- 
levant pointers In the Listeners Pointer Store, 
drop the priority to level 2 and wait u«t11 the 
console orlnters Interruot Is disabled • Indicating 
that all command elean-uo Is now complete, Return 
to steo R for a new input. 


Comments l 

Doubtless the reader will note that two features are Includ- 
ed In TMON, as shown bv Its source listing, but are not co- 
vered h?re, The first of these, the OTHER hooks# was menti- 
oned briefly In a "General Description" footnote and, as In- 
dicated# is presently irrelevant* The second is an embedded 
.READ/.WRTTE processor. , This also serves no Purpose cur- 
rently heeauae, as shown In Section 3, 2*2*2, this routine 
must be resident at all times. However, this may not always 
be the situation. Since TMON is not loaded as a user pro- 
gram, although It operates like one, It does not have the 
same opportunity to have a resident RWn so It provides Its 
own and If neeessarv modifies the MRT to use It* Moreover 
the Loaders# described in Section 5*1 orlolnallv also used 
.READ rather that .TRAN - hence TMQH, in the RUN/GET proces- 
sor# moves its eooy into a buffer for their aceess when re- 
aulred and in fact passes on data In R5 (the wRT information 
on RWN system-device location - or 0) to signal this. This 
data thouah is now.lanored bv the latest Loader versions* 
The processes remain in ease they should be needed for later 
devel moments. 
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6 .5.2 The T hON Com man d a 

This section diseusses commands handled onlv by the transi- 
•nt Monitor in o^d«r_to allow than to have full aeeaaa to 
all the. normal Monitor facilities because no user orooram 
ean exist in core when they are entered. Thev are in faet 
illegal at anv other time. The eomanda covered here are! 

LOGIN 

RIJN/GFT 

FINISH 

As shown in the orevioua section# they all reeeive control 
from .the TmDN general routine with Registers and stack ap- 
propriately act for their eeeceaa to the command by whieh 
thev are celled. Like the other command processors des- 
eribed earlier# thev are then reaDonaible for. decoding anv 
argument entered, and for checking ita validity before Bar* 
forming the function reouired bv the operator. On comple- 
tion# they muat ensure that the correct machine-state is 
passed to the next routine in control. If in fact this is 
again the T M 0N general processor# the contents of P0# R3» 
end R4 remain as on entry* the stack is cleared of the first 
two words, but the others stand. 

The routine must also take care of anv errors, detected ei- 
ther in processing the argument or in execution of the com- 
mand, For eompatibilty with the other eroeessors# they use 
the Special Drivers facility for printing error messages as 
described. in Section 6,3.2. They do this bv simulating the 
recall discussed in Section 6.2.4 with a system-state con- 
forming to the details given in Section 6.2.5. On return# 
thev pass control haek to the general processor to ignore 
the commands. Again Registers and stack are as shown above. 


e.f.a.i The LOGI N Command 

In Chapter A, it was shown that each DOS user can effective- 
ly reserve areas on bulk-media within the system for the 
storage of His own files of Programs or data, with some 
measure of protection against other users. The LOGIN com- 
mand is provided to enable him to identify himself to the 
system in order to. access those files. Currently this is 
its onlv purpose* it is in fact uneceesserv if no unisue 
f 1 1 e-st ruetured operations are to be performed (since any 
user ean eall programs stored in the svstem Library (user 
1#1) or if the users i dent i f i cat i on is entered as oart of 
the aetual f i 1 e-soee i f i cat i on for each task. However its 
use is recommended as. a standard practice for ease of opera- 
tion now and in case in later DdS developments it becomes 
necessary to impose more restrictions upon unauthorized ae- 
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cess to the svste^ generally. 


Command Fomat* 

The only argument currently required Is the Ident i f 1 eat 1 on 
coda for tha user entering tha svstem, Hence the command 
format la* 


L 0 [ G I n ] Group, User <CR> 

Where "Gr 9 uo".end "User" eaeh consist of up to three octal 
ASCII digits in tha ranoe 1-376. 

Not on 1 v Is the LOGIN command illegal If e ereoram Is 
loadedt it Is Invalid If any other user is seen to be still 
occupying the system. 


General Description* 

Provided that the svstem is free to aeeeot a new user, the 
LOGIN processor calls the Conversion Utilities package des- 
cribed in Section 5.3 to convert the two arguments Into 
their eaulvalent binary bytes. The results are stored at 
UIC In the SVT (see Section 2.1.11, In order to warn the 
new uaer that Date and TOD mav need updating, or for later 
reference, it than outputs the current content of the appro- 
priate SVT stores at the console printer. This is accom- 
plished bv a normal .WRITE to the full driver to Print the 
aoproorate heading H D*TF|" or "TIME*"* this Is followed bv a 
simulated. eel 1 to the keyboard Interpreter with a supposed 
command, input without arguments, thereby utilising the cor- 
responding processors conversion facilities to obtain the 
required format. In each ease, the seeond eall Is made 
through the.TMON qeneral processors subroutine for the pur- 
pose, as diseussed In the last section. On completion, the 
general processor Is recalled for a new Input. 


Exit State* 

As noted in the Introduction to Section 6.5.2, the LOGIN 
command calls the Special Driver to handle Its error mes- 
sages. Registers and stack state for this eomply with the 
requirements of Section 6.2.5. In Particular, R1 may con- 
tain* 


•2 ■ Another user on the system, hence the 
command is Invalid. 

-3 » No argument or one containing illegal 

characters or eodes outside the specified 
range 1-376, hence Faulty Syntax. 
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The simulated call to the Interpreter establishes the neees- 
eerv etete as detailed in Section 6.3.2. The remarks on 
general processor recall on completion contained In the In- 
troduction to Section 6.2.5 apply. 


Detailed Processing: 

The simple sequence followed by the LOGIN processor needs no 
Illustration, It Is outlined belowl 

1, Tf the current content of UIC In the SVT Is non-0# 
Indieating another user on the system, call the 
Special Driver to orlnt an "Invalid Commend" mes- 
saaef on return, eleen-uo the stack and return to 
the TMOd general routine. 

2, Otherwise call the Octal ASCII converter In the 
Monitor utilities package to convert "Group Code" 
and store In the 8VT, Repeat for "User Code"# Ig- 
noring the comma separation. If the argument end 
is reached before the two conversions have been 
completed or If either bvte Is 0 or 377 (or above)# 
clear anv value stored In the SVT and eall the See- 
eial Driver to output "Faulty Svntaic", Exit as in 
step 1, 

3, Clean-uo the staek and call .WRITE to the command 
output dataset to print "DATE:". On completion# 
move the first two letters. of the message followed 
by CR Into the command inout buffer and call the 
DATE command processor (see Section 6,4,1) through 
the Interpreter, 

4, Similarly orint "TIME:" and eall the TIME command 
processor (see Section 6,4,7), Return to the TMON 
aenere! routine when done. 


6,5 . 2.2 T he FI NIS H Command 

The FINISH command naturally complements LOGIN In that It 
removes the user Identification from the system, thereby al- 
lowing a new user aecess. It also ensures that the memory 
side of the system Is clean as possible for the new user bv 
rebooting the Monitor afresh from the system-device. 
However it does not Presently attempt to perform any resti- 
tution of peripheral devices# even though this is Implied bv 
the provision of the .KEEP I/n reguest for f 1 1 e-st ruetured 
devices. (see Section 4,6) and the relevant bit In the File 
Protection Cede (see Section 4,1,4), 
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Command Format* 

The FINISH command needs no argument, tta format Is ther* 
fore Simply! 

FI [NJSHl <CR> 

Aoart from the overall restriction that no Program ean be 
loaded* this command can be given at anv time. 


General Description! 

The FINISH processor uses a siml 1 ar . teehnlaue to that des- 
cribed for LOGIN In the last section In order to crlnt the 
time of final log-off for user reference. It then deter- 
mines the svstem-dev 1 ce . f rom the first entry in the DDL (see 
Section 2.1.3) through its SVT polnterj by table look-up* 
this Is eonverted.to the address of the appropriate hardware 
register as supplied to the R0 M bootstrap (see "Starting 
Procedure" In the Programmers Handbook), The hoot Is actu- 
ally accomplished through an embedded version of the ROH se- 
quence. 

As noted above* this completely refreshes the memory load- 
ing* ,1p particular remgvine anv currently looged-ln users 
Identification, However It also clears DATE and TOD, So 
that every user Is not obliged to reset these# the FINISH 
processor does not call for the boot until it h*s_saved the 
present entries out of harms way above the too of TMON (as- 
sumed XX740& If correetly linked for XiT loading • see Sec- 
tions 5,5 and 6.1.2) . They are then restored bv the H 0 n1tor 
Initialisation routine discussed In Section 2,1.4. 


E* 1 1 State! 

No register or stack state Is relevant. 


Detailed Processing! 

The processing of a FINISH command Is again quite straight- 
forward as shown below - hence no 1 1 1 ust rat Ion* 

1, Call .WRITE to print "TI^E*" u»on the command out- 
put dataset. Hove "TI <CR>" Into the command inout 
buffer and throuoh the Interpreter eell the TIME 
command processor (see Section 6,4.7) to outout the 
TOD stored In the SVT. 

2. Save the current SVT entrlea for DATE and TOD 
starting at location XX7400, using tha content of 
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C$A (toe of wei"ory) In the SvT to comnute this, 
(see Section 2.1. 

1. Get the name of the system-device fro" the DDL and 
by table look-up determine the address of Its 
hardware word count register. 

4. Reouest RESET to clear all the hardware registers 
for the device! set Its word-count to -6* and Its 
Stetua to 5 (Read % Go for all disks) - this then 
reads 64 words fren bleek & to memory S, 

5, Wait on the device done flag and repeat from ateo 4 
if hardware errors ere reported. If satisfactory, 
oo to location 0 to execute the routine loaded - 
assumed the Monitor Loader (see Section 9.2, 2, 4) 


6^5.3 The RUW & GET Commands 

Tha RUN and GET commands oerferm the same basic function - 
that of Initiating the loadina of user orograms. It was 
shown In Section 5,1 that the load proper Is effected by two 
non-resident modules LOR and L02 operating from within the 
reatrieted environment of the HSB, To simplify their task# 
all the preliminary work Is carried out by the T M 0N routine 
which processes the two commands Initially and which thus 
has more facility. This RUN/GET processor Is therefore res- 
ponsible for decoding the Input specification and for ensur- 
ing that the Program is available as specified. Further. It 
undertakes the reading of the first part of the prooram mo- 
dule and the extraction and storage of the general control 
Information at Its front. Hence the actual Loader need then 
be concerned .merel v with the processing of the data for the 
program Itself, 


Command Format! 

The general format for both commands Is the same. I.e. 

Dataset Specifier <CR> 

GE[T] Dataset Specifier <CR> 

Where "Dataset Specifier" complies with the reoulrements and 
rules for Command string Interpreter Input • but without 
switches and with soaee. belno a valid keyboard delimiter, 
not Ignored (see Section 5,4). namely! 

[Devlee!] TF 1 1 eneme (• E*t ens 1 onl fUlCJl 
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"Filename" must* of course* be present if the device is any 
for" of bulk atoraoe radium (ineluding maonetie taoe). 
Otherwise the following default conditions aoolv* as further 
explained In the next paragraphs 

a, Devlee ■ the svstem«devlee 

b. Extension a null or LDA 

e, UIC « the 1ooged-ln user or the System [1,11, 


General Description! 

As noted above# one processor handles both PUN and GET, Its 
two entrv points merely set a switch appropriately to show 
the Loader later whether or not to start the proorem auto- 
matically. CSI is first called to perform the Input decod- 
ing ooeretlon, (The input buffer used by TMPfc is already 
set uo to include the required worksoaee# CMOBiJF - see Sec- 
tion 5,4). Provided that some argument has been entered# 
the R'Jn/GFT . processor first eheeks that the soeelfled devlee 
exists within the system as shown bv the DDL* It then uses 
the T/P call ,L0PK to verify the existence of the file on 
true f 1 1 e-st ruetured devlees or the abliltv of a non-file 
device to provide Inout, 

For the former ease* the following seareh algorithm Is used 
( 1)1 

1, If no "UIC" is given* four attemets mev be made to 
find the file as follows! 

a, "Filename, Fxtension" for the logoed-in user 

b, "F1 1 enema, FKtension" under the System fl,11 

e, "Filename" replaced by "FI 1 ename.LDA" as for 
(a) and (b) 

2, No. subst 1 tut ion of "System" occurs If "UIC" Is ex- 
plicitly stipulated - hence only two trials occur! 


1* TMs applies only for full f 1 1 e-st ruetured devices! It 
does not currently Include. magnetic taoe. In its ease# the 
correct comolete specification must be entered as no prelim- 
inary search Is carried out - since this may Involve an en- 
tire pass across the tees (see Section 4,7), 
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a. "Ml ename. Extension" for the specified user 

h. "FH ename, LDA" reolaeing "FI1en*«" for the 
specified user. 

If the file cannot be found or the device cannot suooort in- 
put# the command is rejected bv an eporooriate message 
through the Soecial Driver# as noted in the introduction to 
Section 6.5.2# and the THIN general routine is recalled. 

Otherwise the RU^/GET processor eposes and releases all the 
TMON datasets currently linked CEO* being set to ensure eor- 
reet huf f er-rel ease - see see Section 6.5.1). with the svs- 
tem then restored to norms) state# i.e. tnue FOm (since no 
more ore-load D A T entries can be made)# keyboard Listener 
re-linked to the keyboard interruot vector (also see Section 
6.5.1) and the Monitor/User switeh temporarily set to pro- 
gram run-state (to allow standard keyboard responses to load 
failure.- now reported through ED P - see Chaoter 7)# PU^/GET 
re-initial i?es one dataset for the proaram modyle, It cla- 
ims an appropriate buffer for the device by e direct cell to 
the Monitor S.GTB subroutine# if the deviee is 
f i 1 e-st ruetured or via .O p EM otherwise 

Using .Tran# it then reads date from the program . modgl e into 
this buffer# until it has been able to extract the COMB 
block (see Section 5,1) and store relevant data from it in 
the SVT or on the stack, (in the ease of codes identifying 
additional Monitor modules also to be loaded) Finally it es- 
tablishes the interface reauired bv the loader and calls it 
bv EMT 61. As noted in the previous oareoreph# errors de- 
tected during this oroeess are reoorted as fatal (FP22 ■ mo- 
dule format igcorreet - no COMDf F023 ■ program too large 
for the available core). The operator must then KILL the 
load to continue. 

Exit State* 

Registers and stack state reauired by the loader were deta- 
iled in the introduction to Section 5.1. 

Similarly if the command is rejected through the Special 
Driver ang Twn\j orooer is recalled# conditions ere as des- 
cribed in th« general introduction to Section 6.5.2. 


Detailed Description* 

The RUN/GET processor is illustrated at Figure 6-16, Its 
basic outline follows* 

t. Set a switeh to indicate RU^/GET (m«the latter). 
Peset EOM to the bottom of buffers and relink the 
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listener to the keyboard Interrupt vector (see Sec- 
tion 6.5.1). Re-enable kevboand Interrupts and ne- 
set duS In the 3VT to show program In and running 
ri.11 In e*an errors occur for EOP reporting (see 
3eetlon 2,1,1 and Chapter 7), 

2. Reshuffle the command string to leave only the ar- 
gument. at the sane time converting snaee to comma 
to trao syntax errors. Call CSX to analyse the ar» 
oument syntax (see Section 5,4.1), Then set uo a 
CSl-bloek on the stack and cell CSd to preoara a 
Llnk-bloe* and Pile-block baaed uoon the argument. 
If errors are detected at either call or no argu- 
ment la entered, go to steo 7 to exit through the 
Special Driver for "Faulty Syntax", 

3. Through Its pointer In the SVT. seareh th# DOL for 
the devlee specified (automatically becomes 
system-device through CSI If none Is given). If 
non-ex 1 stent » similarly exit for "Illegal Devlee", 
Otherwise call ,INIT on the oreoared dataset (1), 

4. Call .LOOK to test the existence of the file or the 
validity of the device for Input, (see Section 
4,6,6), Go to step A if satisfactory, 

5. Otherwise eheek whether a UIC soee 1 f 1 eat 1 on was 
stored in the Flle-bloek bv CSI (because soeclfl- 
eellv entered). If so. temporarily ehanaa the eon- 
tent of the UIC in the SVT to the same specifica- 
tion end call .LOOK again (in ease the user Is at- 
tempting to aeeess someone elses file and the re- 
guest Is rejected because Read privileges are net 
allowed - see Section 4,1,4). If the seeond eheek 
Is successful, determine the reletlonship of the 
looged-ln user to the files owner fro* the UICs. 
Provided that the file protection retunned by .LOOK 
indicates relevant .run privileges, oo to steo 8, 
Otherwise check the file extension* If null, repeat 
both cheeks from steo 4 with LDA as a default, 

6. When no UIC is actually specified. recell .LOOK 
with the System UIC substituted. Go to step 8 If 


1. ,TNIT» of course, also performs the devlee eheek (see 
Section 3, 2,1,1), However this mlaht then result in a sys- 
tem error (4003) - somewhat confusing to the user especially 
when he has no knowledge of the Internal ooenatlons at this 
time. Hence RUN/GET forces Its own diagnostic. 
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successful# Repeat both cheeks from ateo 4 with a 
"uM Extension replaced by LDa 

7. Should all the checks fail# set up for "No File" 
opint. Reverse the actio** of step 1 to restore 
the system-state as reouired bv TMQN and eall the 
Special Oliver to aetion the message. Revert to 
the qeneral routine on completion, 

8, If the inout is thus now aceeoteble, release all 
dataset* currently set up (also .CLOSE reouired on 
command inout • ainee oriqinallv ooened). Reset 
E0 M to its true oosition and also T08 and its 
stack-stop, (By the manipulation noted in Section 
8,5,1# the first two are held above the dummy DAT 
and buffer area).(l) 

9, Reinitialise a dataset for the load. Call .3TAT 
(see Section 3,2,4.21 to determine the associated 
device eharaeterist ies, If the driver Facility In- 
dicator shows a f i 1 e-st ructured deviee# determine 
its standard buffer size (see Section 3,3,1) and 
eall the Monitor S.GTB routine to orovide the ne- 
cessary buffer (see Section 2,4,2), Preoare a 
TRAN-bloek aperopr i atel v (see Section 3,2, 1,2), 
Remember the file tyoe as returned by .LOOK and 
whether the deviee is DECtaoe from the driver indi- 
eat©**. Set oointera to force a buffer-fill and go 
to step 11, 

10. Rh#n the deviee is not f i 1 e-st ruetured# eall ,0- 
PEN, mainly to utilize any driver facility for 
checking device-readiness (see Seetiqn 3,3) and al- 
so. to oat automatic buffer allocation and a first 
buffer fill (see Section 3. 2,2.1), From the DDB 
data for the dataset# prepare a TRAN-bloek as above 
(see Section 3,1. 2. 3), When the ,0PEN is complete# 
set pointers to the buffer# check foe magnetic tape 
(also from the driver indicator). Sinee no buffer 
fill automatically occurs in its ease (see Section 
4.7) reset pointers to foree this. 

11, Process data from the buffer# e word at a time# as 
follows - see Section 5,1 for details of format for 
the COMO expected! 


1, This step is followed on the listing by a possible RWN 
move - see "Comment" in Section 6,5.1, 
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s. Ignore leading nulls 

H, Check the first non-0 word. If not l# as re* 
qglred by formatted binary mode (see Section 
3,?. 2, 2)# call "read" error (F32!) through EDP 
(see Chaoter 7) 

e. Store the Line Bvte Count and Ignore dummy Load 
Address 

d. Cheek the nest word. If it is not 3401 (COMD 
code 1 with 7 words following)* call "Format 
Error" (F022) 

e. Save the Program Load-point and check 91*e. If 
the ultimate end Is above available memory* 
eal 1 "Too Large Error" (Fg23), otherwise store 
the load-eojnt at PLA In the SvT (see Seetlon 
2.1,1) and similarly the Prooram Start and ODT 
Start addresses at PSA and DSA. If RUN Is re* 
ouested# store PSA In the RUN/GET swlteh (see 
step 1), 

f. If the relocation flag Is set (currently not 
oosslble)# call "Format Error" as above. 
Otherwise store "Program Name" In the SVT, 

a. Prepare to store a list of the additional M oni- 
tor routines to be loaded on the staek, if the 
next word contains a bvte of 2 with a non*0 
h i oh-bvt e* store the latter as a counter and 
move the following words onto the staek until 
the counter runs out, 

h. If the next word Is 0* the end et the COMO Is 
reached. So save the total number of words 
moved on the staek for loader use and go to 
steo 13. 

I, At each of the above steps (b) through (h)» ac* 
cumulate a bvte eheeksum and decrement the bvte 
eount for the line# saved at (c). If this goes 
0» verify the checksum and eal 1 "Read Error" 
(FP21) on failure. Otherwise reoeat steos "e" 
through "c" and resume from "g", 

12. Should the data in the buffer run out* call .TRAN 
and .wait for a refill (or fill If foreed above)* 
orovlded that no EOD was seen at the last transfer 
(this should never hapoen • If It does call "Formet 
Error" (F022)). On completion# adlust the buffer 
end If not completely filled (EOD now set). 
Prepare the Devlee Block # In the TRAN-block for 
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next tine, as follows and then resume from aten 11 * 

a. Increment currant bloeh If the devlee Is 
f 1 1 e-et ructured and the file Itself Is eontlou* 
ous (sea Section 4. 1.1, 2) - if the devlee Is 
not f 1 1 e*st ruetured# this also occurs but Is 
1 rral event . 

b. If the Input Is a linked file (sea Section 
4, 1,1, 3), extract the next link-word • sat EOD 
for next time If It Is 0 , 

e. If the link is negative and the device Is DEC- 
taoe» adjust for reverse taee*motion (see See* 
tlon 4,2.3) 

13, Ensure that the final COMO checksum is correct 
(F021 enror if not). Than complete Pegister and 
stack state preparation required bv the_ Loader, 
(Moving any EOD marker Into the DD 8 for later 
reference) end call FMT 61, 
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CHAPTER 7 


ERROR HANDLING 


It h«| been. noted et various elaee* In this Manual that fa* 
cognition of ®ome error condition can reault In a eal 1 for 
tha printino of a diaaneatle measaoe at the cons©!# ty- 
pewriter, .The printing aarvlee la Provided centrally bv a 
eoeelal Monitor nodule and i® used by the Monitor and the 
Sveten Program®. The purooae of thl® chapter 1® to de«er1be 
this serviee. 

Section 7.1 explain® the eodlng ®ehene used to identify the 
error®. Section 7,2 shows how the special nodule 1® brought 
Into nenory and the nodule itself is outlined In section 
7.3. 


7.1 Type® of Er ror 


The Prooramme^s Handbook. *how® that all error®, handled bv 
t he_ Q ) aonoet 1 e Print routine appear as an Identifying number 
preflxfp) bv a code letter followed by ®n item of support In- 
formation. e,g, 

7307 23462 

maaning that an I/O regueat waa made from location 23462 for 
a service for whleh no buffer room eeuld be found. 

The purpose of the code letter i® to Inform the user of the 
tfrlousnes® of the error and to indicate the follow-ue ac- 
tion taken by the Monitor. .Internally it Is represented by 
a numbjsr whieh form® the high»order byte of a word of which 
tha error number ia the low-order bvte. The code number Is 
even for error® which are more advisory than drastic or 
whleh ,t)^e program can handlf itself. For these, therefore, 
the program Is recalled after the messaoe has been printed 
end processing continues. The odd number codes are reserved 
for error® whleh at best .need some external remedial aetlon 
and at wer«t mean normal program continuation Is out of the 
guest i on. 

The codes currently assigned aret 

0, Informat i onal (I) - thi* doa® net s1on4fv an error 
condition In the strictest sen®e, Tt allows usage 
of the print routine bv a program wlshlno to notify 
the operator of Its current state, e,g. A Step 
number Is printed in thl® wav by i running FORTRAN 
program bafere It exit® to the Monitor, 
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1, Action (A) • this jndieates that the operator must 
oerferm gone rectifying process before the program 
egn oroeeed, such at ccrreetly setting uo a device 
needed by the program, If the operator reauires 
resumption# he can effeet this by entering a con- 
sol e. CONTINUE command, The Program ia then contin- 
ued immediately following the print reouest, 

2, Warning (W) • this is mainly provided for the use 
of oroqrams whieh need to inform the ueer that his 
results mav he suaoeet.but in the meantime process- 
ing continues* for instance# when LTNK-li enters 
the second pass of a link operation with some glo- 
bal references still undefined. 

3, Petal (P) - this shows that the error is too seri- 
ous to allow resumption. It usually means that the 
Monitor has detected some hardware or software 
problem which cannot be corrected immediately, 
Pellowino such an error# the prooram must be start- 
ed afresh bv a console REGIN or RESTART or it must 
be removed from memory with a KILL. 

4, System Program Error (3) - this is used by a System 
Program whieh cannot oroeeed with its current teak 
but mev be able to. accept a new one after some form 
of re- initial i * at i on # e,g, because of an invalid 
command string input. 

The complete range of the errors within these categories is 
listed in the Programmer's Handbook. 

5, Peal-Time Error (R) -- see R3X manual. 


7.2 Celling Diagn ostic Print 


Whenever a Monitor routine or System Program neede to re- 
guest the diagnostic printing service# it must sucolv the 
code and number for the error amd also the support informa- 
tion to be imeluded in the message. These items. ere passed 
on the stack. The eall itself is made by an IOT instruction 
initially# e.g, the full seguenee might be as fellowsi 


MOV (PC) ♦ # - ( SP5 

.RA05P 'DTi 
MOV CPC)*,-(SP) 

.RYTE 2*1 

o.v jOT 


»PASS DEVICE NAME 

j SHOW ' DFVICE NOT READY' 
f I . E • ACTION #2 
ICALL ERROR PR T NT 
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The reason for this use of I0T is that it provides immediate 
access to a special eheeking routing whieh is loaded with 
the permanently resident Monitor, as oaPt of the initializa- 
tion module described in section 2,1.4. In particular# the 
ultimate erpop message - eoded 0#0 • whieh aionifies 
hardware failure of, the svsten-deyiee# must be intercepted 
since there, is then no ooint in tryino to bring the Diagnos- 
tic. PMnt module from that same svstem.devi ee. Thus if this 
error is detected* the monitoring poutine halts the svstem. 

This special routine is also entered directly as a result of 
illegal trapoinq thpouah unused vectops in the memonv loca- 
tions below 400. It was also noted in section 2.1,4 that 
the. Monitor initial ization routine stores a value in the 
^edition eode positions in each veetor status word and this 
is of eourse combined with the trap priority level set at 7. 
The routine moves this status to the stack, as an error 
number with, a high byte sot at 3, thus producing a valid fa- 
tal error eode, The last entry on the stack at. this time is 
the PC content saved, bv the tract this automatical ly serves 
as useful support information. For compatibility with the 
normal error call through I0T# whieh itself causes a PC and 
statuy save* two words are then 'pushed' onto the staek in 
the direct entry ease. (see Piaure 7-1) 

The Diagnostic Print module is ealled bv the special routine 
bv means of EMT 32. Because of its code it is brought into 
the subsidiary Kevboard, Swao Puffer. Thus as. noted in sec- 
tion _2.3.1* it is possible for diaonostie print calls to be 
made frem_other routines temporarily resident in. the mein 
Swao Buffer* though not by thp. processors within the Key- 
board Language (As shown in section 6.4, these therefore 
handle their own errorsHl) 


1. A problem can arise# however# if an Error Diagnostic 
Print is ealled from an i nterruot *_ (because* for instance# a 
driver has detected some hardware failure. in its device)# at 
the same time that a. keyboard command is being processed. 
The resulting conflict for the use of the KSP cannot cur- 
rently be resolved. Hence the user is advised to take care 
in his keyboard usage while other I/O transfers are under- 
way# particularly on the more complex bulk-storage devices 
(see "Getting DOS on the Air" DEC-1 l-SyDD-D) . 
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7.3 Piaon pa tie Prin t Routi no 


(POP) 


Tha oJaanoatie Print routine h»§ two ** i n functional 


a. To aonyert^tha arrer code and its auooePt in* 
formation into tKa aoprooriata ASCII atrino and 
diaoateh it to the eonaole typewriter, 

b. To control fe11ow*uo action aa dictated by the 
oppop eo da. 


Call Seouenee* 

EDP is aimply called byi 

CMT 32 

Howevap.it exoeete a ataek atata aa dieeuaaed in tha previ* 
oua aaction. 

* # 

Ppocasai no* 

Tha aeguence of ooopationa ia Quito at pai aht f OPwaPd and 
therefora papuipaa no i ljuatration, Tha baaie atapa apat 

1. Sava tha control atatua of. the cbnaoie typewriter# 
to enable ita , restoration aftap the meaaaga haa 
baan printed! wait for any ehanactap currently be* 
ino output to ba finiahad (1) 

?, Output CP/LP followed by tha error coda latter der- 
ived by ainpia table loot*. up baaed on the eode 
number • 

3, Convert both tha error number and euoPoPt Informa- 
tion into petal ASCII# uainp an embedded routine, 
(ainea the normal Swap Buffer may not ba available 
for uee by the Convaraion, Uti 1 itiaa routina dee* 
cribad in aaetion 5.3,), Print the .reeulting ve- 
luaa with a dividing aeaca and finally a aacond 
CR/IF. 

4, Cheek tha error eoda*. If it ia even (aee aaetion 
7,1). reatore tha tyoawpitap atatua and the program 


1. If tha error ia eallad in the middle of a line of out* 
put* the meaeage will in fact intarvana. 
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Registers saved by the E M T call and remove both the 
return PC and status and the eall arguments fro* 
the staek, Free the KSB and recall the program, 

5, For odd eodes# print 'S' to warn the ©eerator that 
command Inout ja expected (see section 6,1) and sat 
the Keyboard Listener inout underway ewlteh (see 
section 6,3) to foree acceptance of that inout 
without CTPL/C. Also transfer the saved typewriter 
status to the Keyboard Listener (unless the latter 
already has a saved value - Indicating that the er- 
ror message has Interrupted the oroeesslnq of a 
command (l)) 

6, Save the program return address in the SVT (WRA) 
and reolaee it on the staek with the address of the 
Syftem Halt Loop In the SVT (see section 2,1,1) - 
this Is actually a switch of the contents of WRA as 
in the console WAIT eommend (see seetlen 6,3), 
A ] so cleer the priority saved on the staek to pro- 
vide for low-level waiting, 

7, Set the Monltor/User switch in the. SVT to show the 

program to be In a wait. state (i,e, - 1» 1 ) , For 

fatal error (code 3) show it also to be stepped to 
prevent acceptance of a keyboard CONTINUE (i,e, 
— 1 # — 1 ) • see Seetlon 6,3,3, 

6, Return to step 4, to elean-uo the stack# free the 
KSB and exit. to the System Wait Loop with Registers 
reset to their content prior to the error cell In 
readiness for program resumption should a console 
CONTINUE be acceptable ('A* errors) 

Comments t 

The Diagnostic Print routine in Its present form Is not 
re-entrant In any sense. Because of this# It must alwavs be 
brought from the svstem-deviee so that it ean be protected 
bv SAM as shown In section 2.3, Moreover any device Inter- 
rupt must-be deemed a potential source of another error mes- 
sage, If this occurred while a previous messaoe were being 
processed# the system would. hano while SAM welted for the 
KSB to be freed • an Impossible event. when the print routine 
could not regain control to complete Its first task, Henee 
presently* the print routine also loeks the system bv main- 
taining the prlgrltv level of 7 set bv the original IOT 
cell. This obviously may mean approximately a seeond during 


1, Any commend currently being Input at this time will In 
fact be. lost# since the setting of the input underway switch 
as noted will effectively delete the string so far entered. 
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whieh no interrupt ean be v aeeepted. Th« user should there- 
fore be particularly eaceful to ovoid foreseeable error con- 
ditions# If ho cannot afford to have deviee access prevented 
for this oerlod. 

It should also be noted that the current method. Is liable to 
change, _ The eodlna svetem was originally designed to oro- 
vide a form of access to a file of error messages stored on 
the. f ystem-dev i ee» with no restriction uoo* the amount of 
additional agpport Information needed in each ease. It Is 
enlv sat at one Item for the time belnp for the sake of aim* 
oHclty.in the earlier stages of DOS development. 'Jsers 
therefore who wish to produce programs which also eall the 
Diagnostic Print routine ^av do so but thev mysj then be 
prepared to amend these programs should the original Inten- 
tion be Implemented later. 
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CHAPTER 8 


MONITOR GENERATION 

and 

MODIFICATION 

The earlier chapters Have jHown that the DOS Monitor eon* 
lists of an in-eore control section supported by Individual 
processing modules stopad within a Lifepopy on the avatem 
device. I? 1* the object of this ehaoter to daseplba how 
the svsten is built crlolnally into this form and than to 
discuss the opoeedupes bv which It nay be extended op nodi* 
fled, 

Monltop generation beolna with the assembly gf the nodule 
seupeea and their subseouent linking. Section 8,1 Identi- 
fies thf requirements fop these two stages. Section 8,2 
then explains the aetual building of the systen-devl ee li* 
bPepy. Section 8,3 Is eoneepned with the pnoblens of ore- 
pacing ,and checking out new op peplacenent nodules ppIop to 
theip final Inclusion In the aysten. 


8,1 ^onltpp Module Preparation 


In Chapter 1, It was noted that a major feature of the Moni- 
tor is the fact that each routine is a completely 
stand-alone nodule at the source- 1 evel , The type of disk 
being used as a system-device and the extent of the Perman- 
ently resident Monitor Section, however, reoulre that the 
modules fre correctly assembled end. linked beferethev are 
included In the svate*.. These operations are therefore il- 
lustrated In the following paragraphs. 


8.1.1 M odule Assembly 


The Individual Monitor modules currently available through 
the DEC Program Library are listed at Figure 8-1, (Refer to 
"Assembling the DOS source Programs", DEC-1 1-SkDA-D, ) They 
are all preoared for processing by the DOS , Asaembl er » 
PAL- 1 1 R, as described In the relevant Programmino Manual 
( DEC- 1 1- ASDC-D) . In General, eaeh is simply assembled 
alonet thus assuming. a DECtape souree# binary cutout on the 
svst em-dev 1 ce and listings on a 1 1 ne-er 1 nter, the neeeasarv 
command string to the Assembler might bel 

*RM0to2,0BJ,LPt, /PA i2<DT3|RM0N2.PAL<CR> 

There are nevertheless two tyees of exception! 

1, System-device Driver - this must execute special 
seouenees which do not aeelv if the same device Is 
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used as an ordinary peripheral In a 
dl f f erent 1 y-based system, As .noted i n Section 
3,3,4, the driven aouree Is eondi t lenal 1 zed for the 
two venslonsi the correct one. Is identified by the 
presence or absence of a definition for the oarame- 
ter SYSDV at assembly. If this la omitted, a nor- 
mal driver is obtained. The system-device driver 
reouirea the following oroceduref 

*DF.0PJ,LP| * /PA|2<KB|/PA I 1 # DT3 I DF , PAL<CR> 

3YSDV«0<CP> jENTER DEFINITION VIA 'KB' 

aC 

.END «CR> ISIGNAL END OF INPUT 

<CR> >I3FE SECTION 6.4,3) 

2, Keyboard Commend Language - as mentioned In Sec- 
tions 6.2,3 and 6.2.4, indexing and overlaying op- 
erations necessitate special assembly to refleet 
the type of disk jn use as a system-device because 
of varying b1oek-s1*e, This aaain means the entry 
of the eoprooriete parameters! they are provided on 
separate source modules! KBIPAR.PAL for PF11 and 
PCI 1 disks? KBIPAR.4DK for RK11, For the modules 
marked In Flaure 8-1, the command string format 

might therefore be! 

#KBL»LPl#/PA!2<DT3lKBIpAR.PAL/PA! 1 #KBL<CR> 


8.1.2 Mpdul e Lin k 1 n o 

The bafle Monitor structure for an installation Is In faet 
determined when the assembled modules are converted Into lo- 
ad format by the DOS Linker. LINK-11 (see the relevant Pro- 
gramming Manual# DEC-1 1-ZLDC-D) . At this time also, the 
Keyboard Command Language Is completely aet-uo. The se- 
ouenee .for linking Indicated In the following operations Is 
recommended particularly if the output Is to rarer taoe 
( i , e , Devlee 'PP') - aee next section! 


8, 1.2.1 Resident Mon 1 1 or 

The, modules which together form the permanently resident 
Monl tor . sect 1 on for an installation are linked into o"e load 
Image In order to complete dlreet references end initially 
prepare, thg ignitor tables (see Section 2,1), Because this 
Image contains the correct settings for the fixed veetor lo- 
cations 4CJ-57, it must be orlolned at location 0, Here* the 
command string to LIN K -11 for the essentially resident mo- 
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dulea# discussed In Chanter 2# mioht be as follows! 

«RM0N,LPi<RM0NlF#RM0N2#R«0W3»RM0^5,nF # PWN,rLnCK/Bt^<CP> 

SRM0M6/E«CR> 

TH# following points should be noted! 

1, RMONl# containing tha Monitor tables .fust come 
first (sea Section 2. 1.1). M e reever# this current- 
ly i* system- device daoendent# in order to onovide 
the pnoosn first entry in the DnL (see Section 
2,1,3). (Hence 3 versions are available! RM0N1F 
for RFll# RM0N1C for RCil, RMqnik for OKU) 

2, OF (or DC or D«) es the system-device driver must 
be assembled as noted in the previous section, 

3, Rwn (the ,RE*D/»HRIT| processor) is presently a ne- 
eeasarv inelusion for reasons given in Section 
3, 2. 2. 2. 

4, CLOCK can be omitted if the conf i gurat i on does not 
include a line-cloek. 

5, RMONfl# as stated in Section 2,1,4# must come last 
since it contains the onee-only i ni t i al i zat i on se- 
auenee. 

As imoljed by these notes# the order of the intermediate mo- 
dules Is immaterial. Moreover# the list can be extended to 
include other modules whieh a particular user wishes to be 
always in _core. That user need merely insert the modules 
concerned* for the appropriate global links wave already 
been established in the MRT (or DDL for deyiee drivers) - 
see Ssetions 2,1,2 end 2,1,3, However# he is referred to 
the eommynts on residency in the appropriate descriptive 
sections in case there are restrictions on such usaae (Key- 
board Commend Modules and Diaenoatie Print# especially). 


8,1, 2. 2 The Transl ent Hon H an 

It was shown that the, prooram exit module expects the tran- 
sient Monitor section to be correctly linked with a too at 
17400., and relocates it to the uooer end of available memory 
on this bssis (sea Section 5,5), Section 6,5 also indicated 
that an embedded version of the ,READ/,wpiTE processor is a 
requirement! The resulting command strino incut in this 
esse is as follows! 


#THON,LPi<TMOH#RW^/T! 17400 /E<CRv 
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THON must e©m* firat, to bo reeognited by MODS. 


6. 1.2. 3 Keyboard Lonou age 

The assembly oroeess for the Keyboard Language module* noted 
In Station 8,1,1 oorveo to orepare each overlaying module In 
tho right for* and to structure the Interpreter Index aeoro- 
priatelv. However oa pointed out in Section 6.2,3, this In- 
dex la dependent upon the feet that the modulea concerned 
are. linked together in e. fixed eeouence. Henee the command 
atrino is. a* follows (an origin at 0 ie, advjaedi nodule KBL 
being unioualy eaUed by ita own EMT code ia excluded - see 
Section 6.2.1) s 

«KBI.LP|<KBX,KBI.DA,KBI.SA,K8I.KB,KBI.OD/Bl0<CR> 

«KBI.BE,KBI.KI,KBI,TI,KB!,M0,KBI.A9,KBI.I5U/E<CP> 


6. 1.2. 4 Other Modulea 

The remaining module* which will normally reside only within 
the ay*tem»dev je* Library must be individually linked aince 
thereafter their only identification ia their Title 
(transmitted bv L I nk • 1 1 a* "Program Name" - aea Section 5,1 
end Figure 1*2). Aoain an origin at 0 ia recommended aai 

*INP,IPJ<INR/Bi0/E<CR> 

*RLS,LPt<RLS/B|0/E<CR> 

etc. 


B«2 Sy ste m Buil di no 


Once all the module* have been linked. e* deaeribed in the 
laat auction, the aetual proeeaa of aettino up the avstem 
can begin. The final objective la a properly eatebliahed 
Library on the avatem-devi ce in the format illuatrated at 
Figure 1-2. In general, the linked module* can be stored 
within thi* Library in any order, with the following exceo- 
t i on* t 

a. The Monitor ROM Bootstrap assume*, that the 
firat module ia the permanently resident Moni- 
tor imaoe. (see Section 6.2.2) 

b. The Program Exit module, XIT, exoeeta the tran- 
sient Monitor Section to eome second (see Sec- 
tion 5.5) • 
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The Library build Is effected bv a soeelal system Loader# 
8YSL00# which Is described in Section 8.2.2, This orogram 
can aeeaet oaeer-taoe input from devlee * PR * and provided 
that the, suggested seauence for linking noted In Section 
8.1.2 la followed# the resulting output Is Immediately ready 
for SYSLOO. However DECtaoe Is also acceptable. Section 
8.2.1 dlseusaes methods of oreparino this. 


8.2.1 Set tin g up a System Deetape 

It is shown in Section 8,2. 2 that the System Loader reoulres 
only a success 1 ve . at r i no of the modules to be, 1 ncoroorated 
into the system-daviee Library. On DECtaoe# this string Is 
a. file# M0NLI8.SYS, conslstino of a concatenation of the In- 
dividual modules,. Basleallv this can be prepared using the 
DOS Pile Utilities Package, PIP-11 (see Programming Manual 

dec-h-piob-d). 

If the linked modules are the only ones with the extension 
, LDA currently In the user's directory# the concatenation 
can be effected In one command string. However It should be 
noted that the DECtape myat be identified with the System as 
uaer. Hence LOG-IN as n#11 is necessary. The aeauence of 
commands to PlP-11 mlaht then bei 

*dt»/ze<cb> izepo the pectapf fop n , n 

e0TlM0NLIB,SY8/FB<*.LDA rUser»* own eodel<CR> 

The use of formatted binary mode Is recommended In order to 
tpke advantaae of Its validity-checking facility (see Sec- 
tion 3. 2. 2.2). Moreover it avoids excessive aaos between 
modules, in the resulting file# since unformatted binary 
merelv eoeles everything seen# including EOF oaddlno. 


An alternative method 1* to prepare a series of subsidiary 
concatenations first# perhaps also on the system-device. 
This method Is useful when other files with ,L0A extensions 
exist within the user's directory (and cannot be deleted). 
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Also* wMU It mav take. longer to enter the individual mo- 
dule names intfally* it does allow retries of smaller sec- 
tions* rather than repeating the whole erocesi should 
transfer failures oeeur. Thus a sequence of f>IP-ii ooera- 
tiona as below is a possibility! 

#RMONA [1, 1J/FR<P«^N.LDA#TM0N.LDA,KBT.0A<CR> 
SRMONR [1 , 1]/FB<INR.LDA,PLS.LDA,TRA,LDA<CR> 
SRMONC [l*l]/FP<ete, 

This Is then followed bv console commands to 'KILL'* 
•FINISH', » L 0 GI N U#ll' and soaln 'PUN PIP't 

SDTI/7E <CR> 

SDT!MONLIB # SYS/FB<RMONA,RWONB ( RMONC., ,<CR> 
iRMONA, PMONB,PMnNC /DF<CR> 

The resulting DECtaee can now be used by SYSL n D* provided 
that .the latter esn be loaded from some alternative device. 
As 9 rule* of course* It must be assumed that, there Is no 
Monitor In eore to help. A paper-tape version can utilise 
the Paper Tape Bystem Absolute Loader (see DEO-1 1-GGPC-O) , 
Howevfr* since a general Purpose bulk-storage device ROM lo- 
ader Is. a necessary element In a 008 eonf i gur at i on* for bo- 
oting the Monitor from the system-devlee* It seems reason- 
able that this should also be used to lead the SYSLOD pro- 
gram , from the DECtape* preferably the one containing the 
Moni tor , modul a file, A Monitor DECtaee Set-up program 
(M0D3J is therefore provided. 

The usaee.ef MODS Is described in the document "Getting DOS 
on the Air* (DEC-i t-SYDD-D) ■ Basically it structures a new 
DECtepe to contain the following items* using either an old 
DECtaee version or eaeer-taee or both as its ineut! 

a, Core-lmaoe of the System Ldsder as e contiguous 
file SYSLOD, SYS in bloeks 1-37, 

b. Special loader for this Image In block 0 (where 
It can be accessed bv the R0 M Bootstrap), 

e, monlIB.SYS as a llnked-flle* with foreed sto- 
rage at the front end of the tape for simpler 
handl Ing. 

MODS also h§s an update facility for modifying an existing 
MONLIB.SYS file (see Section S.3). 
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8.2.2 Leading t he S y stem-De vice ( S YSLOD) 

As noted earlier* the_Svatem Loader* SYSLOD, is responsible 
for the buildina of the system-device Library either fee* 
DECteoe or oaoer taoe. When reouired* it also performs Gen- 
eral i nt i al i *at i on of the ayat em-dev i ea as outlined in Sec- 
tion 4.1. On completion* the user »«y reauest immediate 
Monitor, start-uo. This section describes twese operations 
in detail and also shows how SYSLDD itself is built initial- 
ly. 


8.2.2. 1 P reparation e f S YSLOP 


SYSLOD actually perform* its I/O by normal . Monitor 
proeessesi however by implication the normal Monitor does 
not effectively exist until SY8L0D can be run. The problem 
is solved bv loadino an in-core Monitor version containing 
ell the modul ee cal 1 ed by SYSLOD. This forms the first part 
of the load. module for SYSLOD on OECtape or paper-tape and 
is eelled to initialise itself immediately after entry into 
memory as described in Section 2,1.4, At this time* thouoh* 
the svstem-device eennot be accessed for MPT t DDL set-uo. 
Henee^ module RM0N6 is modified at source level to remove 
this feature which is contained in a subroutine BG.mdI - see 
the appropriate listing. It is replaced by an automatic 
eel 1 Jo SYSLOD* if this has already come fro- DECteoe* or 
for its loading if it follows the special resident Monitor 
on the fame paperteoe • see below. The appropriate code se- 
quence 1st 


BG.MDJi MOV C3A.R0 
BIC #276, P0 
JMP SP0 

BG.MDIt JMP #f PC3+ 

,W0»D BG.MDJ 
.END PG.BSN 


» SET ABS.LDR START 
t (ASSUMED AT TOP OF m E m 0 RY) 

» GO TO APS LOR 
» ENTPY POINT - A SWITCH... 
tOVEPWRlTTFN BY »SYSL0D» START 
f , , , IF ON DT THRU mods 


The whole i.maoe - resident Monitor and SYSLOD - is naturally 
entered at one time if a DECteoe is preoared by 'MODS 1 , 

The Monitor module is linked as described in Section 
8 . 1,2.1. Assuming that the modified RM0N6 is named RMDN6X, 
the relevant LI N K*li command strings for paper-tape output 
(recommended for MODS use also) are 


#PP|»LP|<RMON1F,RMPN2,RMON3.RMON5,DF,RWN/B!0<CO> 

#INR,RL3,TRA,0PN,CLS*DT*PR,F0P,LUK*CkX,FCl<CR> 

#RM0N6X/E<CR> 

As shpwn* the aeoroor i ate syst em-dev ice driver and RM0N1 
version are necessary. 
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SYSLOD , itself Is also dev 4 ee-dependent t Its souree 4s there- 
fere condl t 4 onal i zed end reeuires the entry of e parameter 
et assembly. 4,e. DC»0 on OK«0 (DF_1s assumed bv default). 
Thus the PAL-11? contend string for SYSLOD end subseouent 
peremeten entry mioht bei 

*3YSL0D.LP|./PA!2<KR|,0T3|SY3L0D<CR> 

DCs0«CR> lOEFINE SYSTEM DEVICE ‘PC' 

aC 

,EN0<CR> t SIGNAL. END OP INPUT 

<e«> t (SEE SECTION 6.4.3) 

The. linking of SYSLOO Is st raight forward! however so that 
error end completion halts may be Identified bv their ad- 
dresses# an origin at 30030 Is recommended. Advisedly, the 
linked module should be outout to the seme oaoer taee as the 
resident Monitor module built above (otherwise the automatic 
Absolute Loader etart cannot be effective! the operator must 
halt the computer. end restart et XX7500). Thus the LINK-11 
command string 1st 

*PP1#LPI<SYSLOD/Bt30000/E«CR> 


8. 2,2.2 SYS LOD Us age _ 

The dual-module thus produced or oaoer-taoe can be used dl- 
rectlv or be oroeessed, 1 nte a DECtape epre-lmaoe bv MODS, 
In either esse the operatlna procedure Is fully detailed In 
"Gettlnp DOS on the Air" (DEC-1 1-SYDD-D) • On completion, 
the Monitor Is booted Into memory as described. 


8,2 . 2 .3 SY SL OD P roces s inn 

As shown in Section 8. 2,2.1. the loading of SYSLOD Is pre- 
ceded by that of the special in-eore Monitor whjeh calls 
8YSL0D as soon as It has initialized Itself. The functions 
performed bv SYSLOD ere then es follows; 


1, Buffer Pointer Initialization - SYSLOD performs Its 
jnout of the Monitor module file prepared as shown 
jn the previous sections, bv normal , e EAD whereas 
Its outout while building the system Library uses 
•TRAN. The letter in feet reoulres two forms, the 
modules themselves snd th»e Library Index (see Fig- 
ure 1-2), Moreover ell I/O is double buffered! 
henee six buffers in ell ere reouired end pointers 
are set aeeordinalv! In Particular, the first block 
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oerhaes written is block 8 - set to eo-tain the 
Monitor Loadar (see Section 8. 2. 2. 4). 

2, Inout Determination - the first SYSLOD halt allows 
the operator to set two console switches! 

a. Bit 0 ■ 0 to indicate all input fro* 

oaoer-taoe! 1 for a first inDyt from DECtape 
(mOnjLIB.SYS under user [1,1] on unit 0). 

b, Bit 15 ■ 0 to show initial system-device ini- 
tialisation is to be omitted. 

The input dataset Link-block (see Section 
3, 1.2.1) is adlusted to reflect switch 0. 
Cells to • INIT end .OPEnI for file "momlTB.SYS" 
fellow and an cutout dataset, associated with 
the system-device. is similarly initialised. 
If switch 15 is 0. the next ooeratien is Libra- 
ry-build (see 6 below). 

3, Disk Clear - if the user is starting cemoletelv 
from scratch, i.e. Switch 15 ■ 1* 8YSL0D must 
first determine the csoseity of evailsble 
system-device surface. On RKii, this is 
ore-determ’i ned (see Section 4.2.2). However as 
shown in Section 4.2.1. BFll end RCll are treated 
as a continuous surface, regardless of the number 
of physical Blatters involved. SYSLOD therefore 
uses the hardware facility whieh calls an error for 
►Jon-existent Disk bv attempting to address the be- 
oinnino of eaeh ootertjal Blatter, The resulting 
information is stored for later use (see next oara- 
nraph) and is also set as a control while the whole 
disk surface is cleared. This is accomplished by 
an initial transfer at block 0 as mentioned in (1) 
followed by that of an empty buffer to every third 
block (3.6»ll.ete) up the surface. This is than 
redacted over two more passes to dear the interme- 
diate blocks. 

4, Bit-mao Initialisation • as indicated in Section 
4,1,3. the available system-device surface is con- 
trolled by an aporopriete number of bit-mao seg- 
ments and these era stored at the top end. SYSLOD 
writes out. the necessary preamble to eaeh segment 
and sets bits to 1 as follows! 

a. On the first map. the bits for all bloeks uo to 
the Hardware Protect Line, illustrated at Fig- 
ure 4-9, 
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b, On th* lost map# all bits eor resoondl no to 

non-existent blocks 

5. Dlreetorv Structure - SYSL^D prepares the hasle mfd 
and Svstem UFD described In Seetlon 4,1,? as fol- 
low*! 

a. mfP# 1 - in block #1, containing a Hnk to 

MFD#2# Interleave Factor and pointers to the 
blt-m*o blocks. 

b, MFD#2 -In the bleek preceding the blt-maos 
(see Flour* 4-9), enntalnino UFD Index entries 
for the System (user (1#1J) with a directory 
starting at block #2 and for a general user 
(200*2001 with no eunrent UFD oointer, 

e. System UFDil - In block #2# with a link to 

bloek *3 as UFD#2 and with only one file esta- 
blished - a contiguous one# 'monlIp'# starting 
at block 44 and ending at the Hardware Protect 
Line - 

8. Library Build - SYSLPD expects to start the System 
Library Index In block #4 and the fleet module In 
block #11 (intermediate block* being reserved for 
the permanent, MRT copy -see Section 2.1.2), The 
CQMd for th* first module is read and Its Informa- 
tion. is, transferred , as reoulred Into the Library 
Index bgffer (see Section 5,1 and Flaune 1-2), At 
this time VEMJ Cede.' is. not known and la filled In 
later bv Monitor Initialization, (see Section 
2,1,4), The rest of the module la converted Into 
its core fmaoe, due allowenee being given to the 
Program Load Address at the start of each text 
blgek to ensure the reouislte geos. After conver- 
sion the image Is written out to successive 

sv.stem-deviee bloeks.until the terminal Transfer 
Block at the end of the linked Image Is seen. At 
this point# the last bloek for the module is output 
and the Index buffer Is checked to verify further 
entry soaee. If any, the next module is processed 
in the same wav# ste^tlne from the next 

aystem-devlee bloek. when the Index block Is full# 
the next block Is linked to it (In the first word 
as In a normal linked file) and it Is written out. 
The next module Is then. Indexed In the new bloek 
and starts from the following block# thus erodueino 
the format Illustrated at Figure 1-2. 

7. End of Input - If at any time the origin*! input 
terminate*# SYSLOD, halts the compute# after closing 
and releaslno the incut dataset. As shown In "Get- 


OOSB.BNfl 


PAGE gll 


ting 008 on the A i r" * the user then can Indicate 
further oaoer-taoe inpgt - even after DECfaee* In 
order to enter modifications or extensions • bv 
seating switch 0 t 9 0 and creasing the CONTINUE 
switch. SYSLOH reinitialises the Inout dataset for 
*pp» and oroeesaino is resumed es shown under (6). 
When SYSL00 however detects a 1 In switch 8, It aa- 
sumes no f urt her . 1 ncut . The lest Library Index 
block Is then written out and the output dataset is 
released. A call to the internal eony of the Moni- 
tor Leader follows - see next section. 

It will be noted that SYSLOD does. not attempt to check the 
seouenge of the modules In the ineut file. Hence the user 
must himse]f ensune that the first two are Rmom and TmON - 
as aeieelfied In. the. Introduction to Section 8.2, Moreover 
there Is no restriction on there being only one eopy of a 
particular module. Therefore es stated In Section 2.1.4, 
replacement modules can merelv be added at the end of the 
Input, end these will be used rather than the orlqlnals dur- 
ing Monitor Initialisation, The user of course must take 
care not to oo beyond the available erea defined bv the 
Hardware Protect Line. At the end of input halt, P0 shews 
the next bloek to be used • and thus this Is the value dis- 
played as "Data" in a valid halt. Errors In SYSLOD opera- 
tion are as described In "Getting DOS on the Air". 


B t 2 .2.4 Monitor Bootino 

In th.a or.avi ous sect i on, it, was shown that SYSLnp stores a 
Monitor Loader in Block 0 of the system-device. The R0 M Bo- 
otstrap reads this block (see outline in Section 6.5.2,25 
and starts automat leal 1 v at location 8. The Initial se- 
ouenee gxeeuted bv the Loader Is one which moves the section 
performing the Monlten load Into the memory area starting at 
37000* .In order to leave all lower eore for the module to be 
entered. 

The load seouenee Is then entered. This first reouests a 
direct .hardware read from block *4 (Library Index #1 - see 
last faction). Provided this transfer is satisfactory, the 
startlna block for the first module is extracted from the 
Index (see Figure 1-2), and this combined with the entry for 
site . Is set into the hardwere Peolatera for a transfer of 
the mgdule - assumed pman as noted earlier - Into memory 
starting at location 8, if again, this Is completed without 
error* The Index-stored starting address is set Into the PC 
and Monitor Initialisation commences. 

As Indicated, the loader must drive the devlee because no 
Monitor theoret 1 cal 1 v exists. Henee the routine, like SYS- 
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LOD Is d*vl ee-deoendent i It must Perform it* own conversions 
from "System-bl oek" to actual deviea MoeK (see Section* 
4.2.1 and 4.2.2) t and It doe* net use interrupts but depends 
on flao-t*stino both to determine completion end to receg- 
nice arror-detoetlon. In the latter ease* the eomouter 1* 
halted and the u*er muat trv the Monitor Poot afresh. 


6 ,3 Monitor Mod If leatlon 


Bv no means ha* the DOS Monitor so far described In this 
manual reached It* final stages of dovel opment i moreover It 
1* expected that soma us*?* will wish to adapt .11* feclli* 
tiey to their own ypeeifie need*. Monitor modi f leatlon, a* 
Indicated aerllar# la relatively almpl* owing to it* modular 
structure. The aim of thia section therefore 1* to assist 
those responsible for producing th* new or replacement mo* 
dules, required# bv. summarising their more significant char- 
acter! st lea, end bv illustrating some of the practices found 
useful .during the preparation and eh*ek-eut of the existing 
Monitor. 

Basically the. modules fall into .one of four categories, 
whleh are Individually discussed In sections P.3.1 to 6.3.41 

a. Resident Monitor 

b. Prooram services 

r * 

e. Devlee drivers 
d. Keyboard commands 

However It should again b* noted that because all the mo- 
dules. with the exception of those In category 1. may be 
system-device on core-resident. thev m^at observe the fol- 
lowing eompon rules* 

1, »o*ltlon-!ndepend*nee is asaantlal. 

2, The facilities of the resident Monitor may be ac- 
cessed but only.throuoh the fixed vector locations 
40-56 • see Section 2.1. 

3, Registers or ataek may be freely, used internally to 
a modulo or between modules a* long a* thev are re- 
stored to the original program atete at any time or 
for whatever reason control is returned to that 
program. 
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4. Impure cede* Including fitted storage areas* la oer» 
mlssible only if some for* of protection against 
re-entranev is actually provided* such as the 
■iorced .WAIT on Incomplete I/O (see Section 2.2,1) 
or dr 1 ver-eueu 1 no (see Section 3.1.2. 4) or la Im- 
plied bv the Imposition of some restriction, e.g, 
non-resident use enlv, 

5. It may be assumed that the user program takes ears 
of its own re-entraney • In particular prevention 
corruption of prescribed data-bleeke, passed to the 
Monitor for aceeas or storage* until some reoueated 
service has been satisfied. 

The new modules should all be prepared for eheek-out as des- 
cribed In Section 8,1, As for as Possible* initial testing 
In-core. la advised - the following sections show how. F©r 
the final stages whleh reauire seeess from the 
svstem-dev i ee* the new modules should be added at the end of 
the tibrarv t h rough . 8YSL0D (Rmon A TmOn excepted). If need 
be without destruction of the other content of the 
svstem-dev i ee - see Section 8.2. They can remain so stored 
for normal usage (unless MOOS Is used to update an appropri- 
ate avstem OECtaoe) u n til e complete monitor rebuild becomes 
necessary. (1) 


8.3.1 Resident Monitor M odu les 

Modules whieh ere known to be always eore-residnet ere not* 
of course* so oblloed to be oos 1 1 1 on- 1 ndePendent » since 
linking assures correet address evaluation* Provided that 
any naeeaaarv global references ere Indicated, Furthermore 
thev are rather easier to check out. Their residency* 
however* does make re-entranev a matter of greeter concern 
and If external access to them is reoulred* the necessary 
llnkaoe must be provided - oerhaos through the System Vector 
Table • see Section 2.1.3. 

There Is also the problem of loadlna the resident Monitor* 
after It has been relinked to Include the new module. For 
Initial eheek-out* this can be temporarily accomplished If 
the linked Image ia on oaoer-teoe through the Paoer-taee 
System Absolute Loader (see DEC-li-GGPC-D), In this ease* 
reloading by the seme means must follow any console FINISH 
command • see Section 6. 5. 2. 2. For normal operation* 


1. Before oeneral release, updating the version number 
prlnted.es Monitor Identification after booting Is suggested 
as e neeesaarv oraetlee to reflect anv revisions Introduced 
(module PM0N6), 
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however, the resident Monitor imaoe in the Library on the 
evstem-devi ee must be reolaeed bv the new version through 
8Y8L0D, Ag noted in Section 8,2, it must be the first mo* 
dule, Thgs users who make OECtaoe the SYSL^O input must 
prepare a now file through moos in update mode as shown in 
"Getting HOS on the Air" (15, 

Paper-tape users should Physically examine the first MONLIP 
tape to find the terminal Transfen Bloek for the original 
RMON module (see Seetion 5,1) and tear the taea immediately 
af tar. it, , SYS(.00 is then executed with the new resident 
Monitor as its first ineut, the aeeond half of the original 
tape .entered ne*t and thereafter as normally, while the new 
version is beino tasted* 0DT-11P (see OEC-1 1-nOOA-D) can be 
used in the usual way. 


8,3,2 Pro gram Se rvi ces 

As shown in Seetion 1.3,1, all program services are ealled 
bv E M T» relevant data mav be passed on the stack and this 
must be removed before the program is recalled. The staek 
may also be used for data return. For new or revised mo- 
dules providing these services, the following points are 
particularly relevant* 

1, A ngw module must be allocated an EMT call code, in 
accordance with the conventions given in Sections 
2,2 and 2.3 (soars slots being elreadv provided), 

i.ai 

Code 0-27 ■ I/O Request 

Codes 33-37 ■ Emeraenev service requiring KS* usage 
Codes 40-77 ■ General service usina Mse, 

2, This new module muft also comply with the naming 
convention at Seetion 1,3, 2,1, 

3, Call state is as described for transfer of control 
from the Emt Hendler - see Section 2,2,1, 


1* This facility is not available however for users who 
have OECtaoe but no oaper-taoe reader other than that on the 
ASP-33 Teletype, The driver for this device doe* not permit 
binary data,. Thus although M 0DS is especially written to 
get around this* LINK-11 or PIP-11 cannot be used to produce 
its necessary inout. However, this restriction aopl ies only 
to modi fleet ions to RMON and TMON t other revisions earn be 
effected as footnoted in the next seetion. 
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4, A« potential users of Swap Buffers* the rules dete- 
1 1 ed In Section 2,3,5 -ust be observed. 

5, Pen I/O services! 

e. Driver eel Is must be node through the Oueue 
Manager S,CDB end obey its conventions • see 
Section 3,1, 2, 4, 

b. If eontrol la not returned to the user oroarem 
during the transfer, , WAIT should be called* 
oerheos with 1 ink-bloek simulation, as used in 
the , 1NIT ciroeessor (see Section 3.2,1,1) or 
the F1 1 e-management modules (see Sections 4,4 
through 4,6). 

6, Modules which eannot satisfy their purpose within a 
single Swap Buffer frame nav possibly benefit from 
one of the oyerlayina taehnlouee diseusaed In el* 
ther the pi 1 e-nanaoement operatlome (see Section 
4,3) or the Keyboard Lenduage (see Section 5,2), 
However the llmltetlone In both eases should be 
noted. 

The npw module should be assembled as shown in Saetlon 
6,1. 1« . For tha Initial stages of check-out. It should be 
ljnkfd and loaded with its test program. Before testing be- 
gins, howeyer, the relevant MRT slot (see Section 2,1.2) 
must be modified to show the module's In-eore start address 
(Actual Start*2 - see Section 2,3.1), Assuming 0DT-11R Is 
alto loaded with the teat program, a simple way of accessing 
the^slot reeuired Is by means of the SvT (see Section 2,1,1) 
as follows! 

ODT-UR V002A tODT CALLED AFTER 'GET' 

40/000400<CR> i SVT START - ADD 46 

446/000466<CR> I MRT START - ADD C0DE*2 

502/000135 YXXX <CR> lENTER NEW ,IMT, SAY 

Thereafter testing under DDT-11R ean be carried out in the 
normal way as for any In-eore program (although the user 
should avoid setting breakpoints actually on EMT Instruc- 
tions), There Is no need to restore the MRT as this Is au- 
tomatically refreshed, when the test Is KILLED, 
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One* the woeful# la apoarantlv eetlafeetory when ln-eore, It 
ean ba added at the and of the Library on th« ayaten-devlee 
bv a freah SY3L0D# aa noted earliao for cheek-out under 
ewaepine condition# (1). 

Another atao may ba neeeaaery# thouoh# if the nodule la com* 
plataly new# i,e. It uaea 9 erevioualy unallocated E M T call 
coda. The mrt *uat be modified# In RMONl# to ahew the wo* 
dule'a global n#w# and tha Monitor. Initial l*#tion routine'# 
reference ahaat In RM0N6 wuat be aimllarly aw ended, (aae 
Section 2.1). Thia. mean# that a new resident Monitor wuat 
ba linked and alao atored In tha Library aa diaeuaaed In tha 
pravloua aactlon. 


1, Although the uaer Mho haa only ASP-33 paper taoe feelll- 
tiaa la generally at a dlaadvantaoa at oreaent# aa footnoted 
In tha erevioua aactlon# Na can add hi# new module to the 
M0NLI8.3Y3 file on DtCtaoe under PIP aa follow#. and than 
3Y8L00 in th# normal wav (provided that the module ia only a 
replaeawant for an aviating onai 

UOGIN 1 # 1<CP> 

SRUN PIP<CP> 

PIP-11 V004A 

*MONLI«.SYS/FB<DT|M0NLIB.3Y3#DP|POOULE.LOA ruiCl<CP> 
#DT|MONLIB.8Y3/PR»0«CP> 

«DT|M0NLIB.3Y3/DE<CR> 

P0T|/FB<M0NLTB.3Y8<CP> 
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# • 

Cheekino the module now that its presence in memory Is 
ephemeral Is of course somewhat more difficult. The teehni- 
oue found most satisfactory Is to breakpoint the test pro* 
pram Just nrier to the EMT call and then the SAM routine at 
the instruction which actually passes control to the module 
whan loaded in the Swap Buffer (currently RMDN2*300) e,q, 
the ODT-llR seauenee mioht be* 


30000 i 1 P 

40/0004P0<CR> 

454/00064«<CR> 

652/000766<CR> 

766*2R 

l.XXXfB 

2 » 300 l B 

1 # 0 I G 

80 f 1 r XXX 

|P 

81 *2, 000300 

*13 

|P 

88*2.000462 
2* 460 * 3R 
502/00 1 00 1 <CR> 
3.«2/001001<CP> 
|3 

3. YYYlB 


M4PK program start 
SVT START - ADD 50 
DDL START - ADD 6 

ddl End ■ emt start 

SET RELOCATION FACTOR 
BREAKPOINT TME TEST PROG. 
...& SAM 
START THE TEST 
TEST BREAK 

CONTINUE TO SAM BREAK 

SINGLE STEP TO.,. 
...module START 

MARK MSB. START 
PEPHApS CHECK MPT 
...AGAINST MODULE IN MSB 
...(SEE SECTION 2.3,1) 
BREAKPOINT THE MODULE 
... & CONTINUE 


Again the module can He tasted under ODT-llR control. One 
word of warning however* ell breakpoints within the module 
must he„removed before it returns control to the teat pro- 
gram if there is any possibility that a different routine 
may be brouoht into the Swap Buffer to replace it. 
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8 .3.3 H «v<ee Dr 1 ve r a 

The format and operations expected of a devlee-driver wer< 
discussed In Section 3.3. and this referred to the mere de- 
tailed daacrlotlon alvan aa Appendix G of the Preoramner ' a 
Handbook. cnee preeared# the new driver ean be assembled 
and linked for normal uaaae aa ahown In Seetlon 8.1. 

Aa wlth.preoram raaueat modulea covered In the laat seetlon# 
the driver ahould first be linked and loaded with Ita teat 
routine for, In-eor# checkout. In thia eaae the DDL muat be 
modified to reflect Ita presence (see Section 2,1.3), For 
this# the use. of an exUltna entrv for a device not eetuallv 
In the eonf i ourat 1 on la recommended# e.o, the 00T»tlR ac- 
tion mloht bet 

40/000400<CR> |SVT START - ADC 50 

450/0?0646<CR> f DDL START - ADD 20 

666/063320 I* PR <CR» » ADD 10 

676/06320 0»* PP <CP> | ADD 10 

706/046600 1 y LP DV <UF> *Re p LACE 
7104000000 X*XXXX<CR> jENTER CORE ADDRESS 

The user must eeoroer i etel y aet the Interrupt vectors at 
this .time# since .INIT onlv does this for drivers brought 
from the Library (see Seetlon 3.2.1.1). 

For final checkout when brought from the system-deviee# the 
new drivpr mav also be added to the end of the Library by 
enterino it from oaoertaoe through SYSLOD (see Seetjon 8,2), 
At the same time# the DDL In RM0N1 must be updated if neces- 
sary# in mueh the same wav aa „ the MRT # aa Indicated In the 
last Seetlon. No modification of RM0N6 however la needed. 
ODT-llR control for the eheck-out la a little simpler* the 
dMveHa eore location ean be readily determined immediately 
after , the dataset using It has been .INTTFD bv examining the 
approoriate DDL slot. Driver break points can of course re- 
main until the dataset is .RLSEd. 


8. 3.4 Kevbo ard Comm an da 

The. 1 mp J ament at 1 on of a new Keyboard Commands depends uoen 
their Intended usage. As ahown In Chapter 6, If a command 
can onlv be given when no prooram Is loaded# it la eroeessed 
bv a routine embedded In the transient Monitor, On the oth- 
er hand? if It can be given. at anv time# its nmeeaslng rou- 
tine _muat be Ineoroorated into the Keyboard Interpreter mo- 
dule for swapping In as reaulred. In neither ease, is the 
procedure, simple# as the following oaragraphs will shewi 
Monitor extension In this area by the oeneral uaer is not 
therefore advised. 
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8.3 .4. 1 Mtw TMON commands 

The inclusion of new commands wh i eh ean onl v be effected 
when TMON ha» control of the machine ere fairly simple to 
prepare ainee thev can assume all normal Monitor faeilitea 
and can use the provisions of the T*0*' general processor 
described in Section 6,5, Moreover it la enlv TMON itself 
that need be modified,. However checkout ia a problem# 
ein$e,the uaa. of 0DT-11R implies a loaded program and bv de- 
finition# this doga not exist. Various teehnioues were 
therefore triad durino the development of the current ver- 
aion of TMON - oerhane.the aimeleat is. to link 0DT-11R to a 
TMON module which contains HALT aa ita first inatruction (1) 
arid atore the resulting linked imeoe in the ayatem-devi ee 
Library aa daaeribad in Sections 8,1 and 8,2 (2), The HALT 
than allows the user to raatart the machine under ODT-llR 
eontrql . through the eonaola switches (starting at nnT-liR 
loed-eoint t 172). Cheek-out operations mav then proceed aa 
nermallv exeeot that a loaa of dabuoQina control can only be 
rectified manually# i.a. . The eonaola 00T. command ia not 
available. ,A new 3Y3L0D without 0DT»11R linked muat of 
couraa follow successful taatino. 


6. 3. 4 . 2 Ot her Commando 

Aa noted in the introduction to Section 8.3.4, new commando 
which ean be entered by the operator at any time muat be 
processed within the Keyboard Interpreter dee Section 
6.2.3), Not only therefore# muat they in general obaerve 
the. points liated at the start of Section 8.3.2, ainee they 
also affectively result in an EMT eall» thev fhould alao 
eomolv with the eonventiona diseusaed in Section 6.2.5, 
Moreover, the following cona i derat i ona are alao relevant! 

a. Module KBI muat be modified to include any com- 
pletely new command in ita index aa indicated 
in the commenta on the appropriate listing. 


1. It ia not expected that TMON expansion ia a likely re- 
puirenent of a uaer who haa an 8K configuration. .The pro- 
eeaa described ia almoat certainly impossible in thia amount 
of available memory. 


2. In eraetiee, the uae of MODS to update a system DECtapa 
ia adviaad. Paper tape users (device *PP> that ia) can use 
the same teehniaue as that described for RMON in Section 
8.3.1, - in this ease# the second module of the first MONLIB 
tape is phyaieallv replaced. 
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b. The module Itself must handle Its own ooera* 
Mens - it esnnot deoend uoon other Moncton fa» 
ellltles (see Section 6.2.4), 

e. It follows from (b) that everlavino of tha ava» 
liable 128-werd k38 Is especially probable, 
Reference to Section 6.2.3 and tha listing for 
s similar exlstino command (ASSIGN perhaps) la 
strongly recommended, (notine dartieularly Its 
structure for ensuMnq correct system devlee* 
storage whan aaaemblad with the correct oarame- 
ter taoe • saa Section 8.1) 

Checkout of tbe new command is also complex. As noted in 
Section 6,2.5, tha keyboard Interpreter and Its associated 
modules, can never be eore»reaident y hence the composite 
linkad»1mage must be built from the start (see Section 6.1) 
and ODT-ltP control can only be maintained basically through 
tha SAm entry Into the module as illustrated In Section 8.2. 
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Even this reoulrea some effort, because of the overlaying 
normallv effected for the language. The following seauenee 
depicts tMs (assuming 00T-11R has been loaded as a running 
program and. a breakpoint has been set in 9A* as In the exam* 
pie In flection 8,2)* 


81 *2,000300 
)P 

*91 ,2,000300 

»P 

CBl*2, 020300 

*P 

91*2,000310 

|P 


USER ENTERS CTL/C 
PIPST KBL CALL 

•*• echo 

»C ECHO 
<CR>ECH0 


91*2,2000300 

»P 

,B1 *2,000300 
*P 

81*2,080300 

*P 

091(2,000300 


*P 

81*2,000300 

»P 


<LF> echo 
ECHO 

USERS FNTERS 'O' 


•d* Echo 

FOLLOWED BY COMMAND 
,,.(2 BREAKS PER INPUT! 
TERMINAL <CR>ECH0 


B1 *2, *00330 
» IS 

88*2,750 

2,746*3R 

446/466<CR> 

550/000535<CR> 

534/001021<CR> 

3,-2/000535<CP> 

)S 

)P 

/0010?1<CR> 

)P 

/001201<CP> 

3, XXX I B 
»P 


«LF»ECH0 

SINGLE step TO.,. 
...get ksb. start 
mark it 

MRT START - ADO 2*31 
CHECK KBL ENTRY 
CHECK KBI ENTRY 
CONFIRM KBL TN KSB 
...i CONTINUE 

CONFIRM KBI IN KSB 

CONFIRM CMO PROCESSOR 
SET FIRST B/p. 

... * CONTINUE 
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Now the •oe' , oor1«to processor Is in the K8B, debuqolnp eon 
eentlnu* •• before, Psrtleulee ear* Is obviously needed# 
net to lost eontrolf the eowsents on breakpoint removal In 
Section 8.2 are aoain relevant. Trapofna the Sam e»trv Into 
a further overlay ean be left to oeeur naturally if neeessa* 
rv# e.o. 


»* 

2# 300 » B 
»P 

B0 1 2# 000300 
3#» 2/P012 05<CP> 
3# VYV »B 
»P 


fPE^OVE ALL B/P 
fPESET AT SAM ENTRY 

ioverlay NOW TN ... 
»... though check 

f SET new FIRST R/P 
I... 8 CONTINUE 


noopuk £9 


P(?£S£NT ItNl 3>0 ■=>-!» fOONiroft (v4*) 
[emr Ca.il Codas, m po.rcoH>c.s®^ 


I. 6 asic ^esidedf fOooilbr , i - 

RrooNiF (dP-ii) / fcnoc>N»C («CMi)/«coor-4iK(<?X-ij) 
ftfOONi 

CfT)oM3 

««loKS 

CW5C< 

ewN. (s/h) 

3)^ C cfr -*') / Oc. (<?C-u)/DK («.K-ii) 
ftoooHfc 

iS. . Pnoci pa' X/ O Poohnee.:- 

I«NR ( t) 5 TT 0 ^) RSN (W*> 

3>X« C>4.^ p£u CS»> 

fluD c*5) ««> (aa> 

oPrJ Ob) P«o C& 4 > 

S^C Ofc) C.U© (»7) 

3. 5ob>»iciiciciJ Pile- roa n ctQe rn C-olT oe_o:~ 

K>P (u.3) <SrT0f) (j5#) Dcn (Sq.) 

PCR (4M.) Cft« (51) 

FCI- (46 > CKX (52> 

UOK (4(a) J>i_tsl (S3) 

uftft (47) 

. Ort^er fOooihsr Se^vtce.^;- 


( 

PCS. ( 7 ) 

TR« 0*4) 
8 xo c » 0 
OS? 


— — ■» v r/ 

CS&> 
nryTo (03) 
G*fO 


(a . I>e- 


vice 


Got (u.i> 

C6rr> (S7) 

U>« (fei> 

CvT (m.2) 

X »T ObflO 

u>a C«s 

CSX (S4») 
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K8k (3i) 

kbx- ec 

X6X.no 

ei>P (31) 

KBX- os> 

xer.fls 

KL&r Ck0 

KBX. Be 

K6XDO 

xsr.ufl 

xei. <i 

TVoortf 

KBX.SP 

KSA..TT 


i)r.vcr«,; — 



A ^no 

ro ])PxA>CX 

^KX 

K6 

i_p 

CR 

PR 

3>T 

Or>T 

PP 




.joc-e 


2 * 





CHAPTER 9 


SYSTEM PILE FORMATS 


9.1 Obleet Ho du 1 • Fo rmet 


An ebfept module is the fundamental unit_ of, inout to 
LINK-11. Furthermore# each input file specified in the com- 
mand string may contain multiple object modules. Eaeh ob- 
ject module contains several functional parts. Two reauired 
parte, art th# global symbol directory (GSD) and tpxt bloeke 
(TXT). At least one relocation directory (RlD) ia also ne- 
auirad* Normally there are many RLD’s oraaant. Each RLD is 
associated solely with the text block which immediately pre- 
cedes, it. The optional fourth part (not vet imolemented) ia 
the internal evmbol directory (ISD), The end of the objaet 
modu1,a_.ia aoeeified by a block containimg only the 
"tnd-of-modul a" command. Refer to Figure 9-1. 
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9.1.1 flblect Module's C ontents 


9. 1.1.1 Global Symbol Directory 


T^e GSD holds ell 1 n forget 1 on necessary to assign absolute 
addresses to all global symbols# to eause the proper library 
searches and to create the load module’s COMD. 

The GSD contains three tyoes of global symbols (In addition 
to other type* of Information specified below)! 

1. Program section names 

2. Definitions for symbols whieh have been declared to 
be entry symbols (entry points) 

3. References to symbols whieh have been declared to 
be external (external references) 

The G3D , must be constructed such that once a program 
seetlgn's name has been declared# all the entry symbol de- 
finitions within that section must be declared. The deelar- 
etlon of a reference to an external symbol mav aooeer any- 
where in the GSD, Upon completing a section's declarations# 
the next program section's name may be declared. 

The GSD will generally consist of several formatted binary 
lings. Each line will start wjth a command indicating that 
It Is a part of the GSD. The first line of the GSD will 
have the modules’s name# packed in ,R*D50 form# Immediately 
following the GSD command. The f o 1 1 cw 1 ng lines will have 
the GSD.eommend and a continuation of the GSD data. The GSD 
is terminated bv a line containing only the GSD termination 
command. 

Every ohjeet module must begin with a GSD line which con- 
tains at least the ebleet module's name. The remainder of 
the GSD# however# may be anywhere In the module. The linker 
will Ignore all non-GSD lines while It is gathering the GSD, 
Refer to flours 9-2. 
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The GAD It terminated bv the end GSD obleet e©m-and. 

The entries In tha G3D adhere to the followino conventions* 

1. Evtrv object module contains exactly one GAO. 

2. Every symbol (nemo ) mutt be oresemted at a double 
word. This double word reor#semta 9 sacked .PAD50 
ascension of the symbol's a f it ascii characters. 
The first word holds the peeked reeresentet ion of 
the symbol's first three characters. 

3. Every entry must possess a word containing flag In- 
formation. The bl t .assignments (Individual flags) 
must conform to the following sped f lest Ions* 

Bit « Reset/Set 



3 yndef InaH/def Ined 

6 Internal /global 

9 sbsol ute/rel oeatabl e 

0 , 1 . 2 . 4. 7 not used 
8-19 eoded octal 1v as follows! 

Qapbjeet module name 
lsorogrsm section none C.ASECT or 
•C9ECT assembler directives) 
2 «interna 1 symbol table name (not 
vet Implemented) 

3*trsnsfer address. seeel fleet ion 
4atymbo1 deelaraetion 
5siecsJ section name 
Ssversion Identification 

Mote that the hlah order bvte of the fleas is used 
as a command to Identify the tyoa of entry. The 
low order byte Is used to apeelfv oartieular Quali- 
ties of the entry. 

4. Every program section. and local section entry must 
declare the total dimension (in bytes) of the en- 
tire section. 
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5. Everv relocatable .entry symbol definition must 
etatt Its definition, relative to the base of the 
sect Ion, 

8, All entrv symbols of a section must fellow the de- 
claration of the section's name. However# external 
symbol references mav occur anywhere In the GSD, 

7, The size of a section is defined as fellows! 

a. The absolute section has a size of 0. 

b, A control section's size la one olus the larg- 
est relocatable PC value assigned during assem- 
bly, 

8, The t ransfer . address Is specified In the GSD so 
that the linker can include it In thf C0 M D of the 
lead module. If no transfer address is specified 
in the G8D# r the linker will assume an address of 
000001, The first transfer address specified wljl 
be kept. The exorssslon on the .END statement is 
resolved down to a displacement from a program sec- 
tion (or local section) name, 

Examolei 

■ CSECT NAME 

A! 0 
01 0 

C! MOV mumble# sp 


.END c »the RELOCATABLE transfer 

(ADDRESS 

(IS DEFINED TO PE THE VALUE OF 
(THE BASE OF CONTROL SECTION 
("NAME" PLUS 4. 

The linker plaees the finalized absolute _transfer 
address in the C0MD and In the TPA bloek of the lo- 
ad module. 

Refer to Figure 9-3 for an Illustration of the GSD 
without the Blocking Structure, 
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9.1. 1.2 Test Bloek 


Uoon Ineut to IINK-11, the test blocks nonmallv contain 
bvtea and/or words whleh have vet to be determined. That 
is, poeitiena remain within the test block whose contents 
must be determined bv the oreeesses of relocation and link* 
Ino. The contents of these posit jone.ane total 1v specified 
bv the, relocation directory which follows the test block. 
If a test bloek does not need modification, then an RLD need 
not follow. Thus, multiple test bloeks may oecur eontlou- 
oysly Ip the module. Uoon inout to. the abeol ute loader, the 
load module's binary bloeks contain aolelv absolute binary 
load date end absolute load oddnesses. 

Each test block must beoln with the object command which de- 
clares .this block to be TXT. This command Is followed by a. 
word whteh states the memprv location where the first date 
bvte of this test block Is to be pleeed. This word Is fol« 
lowed bv the body of the test block. Refer to Moure 9-4. 
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9. 1.1. 3 R e 1 o c a t J on D< r • e t o r y 

4 

Relocation directories contain the necessary nbjeet commands 
and their supportive arguments raoulrad for modifying (relo- 
eatino gntf/gr linking) tha proceeding text block. Refer to 
the definition of tha object language* section 0,1,2, Refer 
to Floyre 9*8 for a RID block. 

Each RLD mpv eontajn joed address modification commands 
and/or text modification commands. Load address commands 
may not.be followed bv text modification commands in the 
same block (11 na) . 

Eaeh obJeet module must have at least one RLD which ereeeeds 
the. ?ie«t TXT bloek. These RLD'e must. contain load address 
modification commands whleh start the linker at tha orooer 
pi aea. 


9.1. 1.4 Internal Symbol Directory 


(Not vat implemented) 
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9.1.2 Ob feet La * o u a g e 


The object language Is the set of ell commends which Indl- 
eete the tvpe of e block end which eopeer In an RLD to con- 
trol the llnklno and relocating orocese. 

The general structure o* all objeet commands 1st 


t. A command is a byte Quantity 

2, The elan bit Indicates a bvte operand (If set) 

3. Potentially 128 commands 

< * , 

The object language contains several general tyeea of com- 
mands t 


Tvoe I , Block Type Declarative commands 


Coda (Octal) 


a. Declare the G8D 1 

b. Declare a TXT block 3 

e. Declare a RLD block 4 

d. Declare the I8D 5 

a. Declare the modules'* end 6 

f, Declare GSD termination 2 

g. Declare a library 7 

h, Declare the library directory end 10 

1. Deejare a eora library 11 

I. Declare a core library and 12 


Tvps II. Text Modification Commando 


This group of commands apoear In the RLD and per- 
form the relocating and/or linking function. They 
ooerate udoo specific bvtea on words In the TXT 
bloek and therefore reoulre a. method for referenc- 
ing Quantities in the associated text bloek. 
Thus# the second byte of each of the following 
commands is a bvta which specifies the displace- 
ment from the base of t h e teat block to the refer* 
eneed text da$a bvte (or word)*. The base of the 
teat block ia the location of the first byte In 
the bloek! that 1a f It la a displacement from the 
TXT command. 
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1* Internal Relocation (Octal Cod® It 

Add the current preorem section's bate to the 
aeeelfled constant and place the result where 
4 ndl eatad. 

CmO (Bvt a) 

Reletlva Reference (Byte) 

Constant (Word) 

T h 4 a command relocates a direct pointer te op 
Internal relocatable ay*bol. 

Exempt at 

At MOV #A,X8 » the relative definition 

» OF "A" APPEARS AS THE 
» CONSTANT IN THE CO m HAND 

2. Global Relocation (Octal Coda 2) 

Place the. value o* the specified otobel symbol 
where Indicated. 

CMD (Bvta) 

Relative Roforaneo (Byte) 

Global Symbol (2 words# Packed .PA050) 

This command eeneretea a direct pointer to an 
external symbol. 

Exempt at 


» ASSUME "A" IS 
t A GLOBAL 

mov pa# t the name "a" 

t APPEARS IN 

» the command 
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Internal Displaced Relocation (netal Code 31 

Calculate the diaolaeement from the position 
of the current location eoynter (plus 2) to 
the aoeelfled abaolute address. Place the re* 
suit where indicated. 

CMD (Bvt e) 

Relative Reference (Byte) 

Constant (Word! 

Example! 


CLR 177550 | A 17755* 

I APPEARS A3 
I THE CONSTANT 
» IN THIS COMMAND 

Note that this tyoe.of relocation oeeurs only 
when there Is e reference to ao absolute sym- 
bol from a relocatable section. 

Global Displaced Relocation (Oetal Code 4) 

Calculate the displacement from the position 
of the current load location counter (olua 2) 
to the specified global, Plae# the reault 
where Indicated. 


CMD (Byte) 

Relative Reference (Byte) 

Global Svmbol (2 words* peeked .RAO50) 

Example! 


MOV 


! ASSUME THAT 
! "A" IS A GLOBAL 

t the name "a» 

! APPEARS TN 
i the command 


A, *0 
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S. Global Additive Relocation (Octal Code 5) 

Add the valya.of the specified olebal symbol 
to tha specified eonatant and olaca the result 
whafa Indicated. 


CMC (Byte) 

Relative Reference (Byte) 

Global Symbol (2 Words* Peeked , RADS0) 
Conatant (Word) 

Exenpl el 


MOV 


#A+6»%0 


I ASSUME THAT 
t A IS A GLOBAL 
» THF 6 

I APPEARS AS THE 
» CONSTAMT 


6. Global Additive Dlsolaeed Relocation (Octal 
Code 6) 

Calculate the displacement from the position 
of the current location counter (plus 2) to 
the address .seed feid to be the sum of the 
specified constant and the specified global 
symbol and then glees the result whara indi- 
cated. 


CMO (Byte) 

Re.letlve Reference (Byte) 

Global Symbol (2 W 0 rds* Paeked .RAO50) 
Constant (Word) 

Example* 


t ASSUME THAT 
* A IS A GLOBAL 
CLR ASfl l The 6 

t APPEARS AS 

i the constant 

Example* (FORTRAN) 


common/label/l»n,m/ 

Map 


These statements would eause the followino In- 
struction to be generated* 

CLR LABEL+4 » LABEL TS A 
* GLOBAL 
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7. Set Preoram Limits (Oetal Cede til 

This command (generated bv the .LIMIT assem- 
bler directive) .causes two words In the TXT 
bloek to be modified. The first word is set 
to the lowest relocated address of the pro- 
gram. The second word is set to the. highest 
relocated, address til that Is# the first free 
location following the relocated eode. The 
command consists of just one word. 

CMO (Byte) 

Pslstlve Reference (Byte) 

Note that both words to be modified must so- 
pear in the same TXT block, 

8. .CSECT Text Modification Commands 

Four .CSECT text modification commands have 
been added to the assembler's obfeet lanauage 
repertoire to accommodate .CSECT neloeatlont 

octal Command 


1. .CSECT relocation 12 

2. .CSECT displaced relocation 14 

3. .CSECT additive relocation 15 

4. .CSECT additive diaolaeed relocation IS 

The LINKER currently maos these commands Into 
the corresoondi no .GLOBL text modification 
commands. However# If and when the LINKER la 
modified to .distinguish between ..GLOBL and 
.CSECT names it will be possible (without mod- 
ification to the assembler) fop the user to 
have .CSECT's and .GLOBL's with the same name* 
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Tvpe TIT# Location Count#** Modification Commands 

These eommanda aopoar in the PLD and control the 
aattlno of the LINKEP'a currant location eounteri 
that la# thav control where the absolute load data# 
within the neat teat bloc 1 *# la to be elaeed Into 
memory. 

The objeet module must have at least one BID# con- 
taining the proeier location counter setting and/or 
modification eommanda# preceding the flrat 
ble e k. 

These eommanda# which must be last In an *1.3# 
the load eddreas for the neat TXT block read. 

1. Location eountar definition (Oetal Code 7) 

Sat the currant location eountar eaual to 
sum of the aoeelfied program section's base 
dress and the specified constant. 

CMD (Bvta) followed by a null byte 
Program Section's Name 
(2 Words# Packed .RAD30) 

Constant (Word) 

This command Is generated whenever a .ASECT# 
•LOCAL# eh gCSECT directive is used to Initiate 
or continue a Program section. 

2. Location Counter Modification (Oetal Code 10) 

Define. the Currant Location Counter to be the 
sum of the current proarem section's base ad* 
dress and the following constant. 

C M D (Bvte) followed by a null byte 
Constant (word) 

Eaamol ei 

,«1<*0 I 10*1 apDaara as the constant 

.■.♦1003 i The value of '.♦1000' 

» appears as the constant. 


TXT 

set 

the 

ad* 
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0*2 Lead Module Format 


The normal output of the linker la a load module 
be loaded and ru*. The Pheee I imolementetlon w 
onlv a load module. Pheae II will Include the 
producing e 1oad«time reloeateble module. 


.whleh mev 

ill oneduee 
ootion of 
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9*2.1 i pad Module Contents 


A lead Mul* consists of formatted binary llnej holding ab- 
solute load addresses and objaet data aa specified for the 
paper tape system absolute loader. The first few words of 
data will be the communications directory (COHD) and will 
have an absolute load addraaa eouel to the lowest relocated 
addresa of the program, Tha abaolute leader will load the 
COMO at the soeelfled address but then the. program will 
overlay the COMO. The dlak monitor will exoeet the.COMR and 
will load it whera the monitor wante it. TKeerd of the lo- 
ad module will be indicated by a TRA block* that Is* a line 
containing only a. load address. The byte eount In the for- 
matted binarv line will be 6 on thia line. On all other 
lines the bvte eount will be larger. then 6. The load module 
linea* the linker output* have the following format* 


let Bytei 


2nd Bytei 


Low order byte 
mode 
( 001 ) 

High order bvte 

atatua 

( 000 ) 


3rd and 4th 

Bytes* Aetuol bvte count 

(from let thru 
last byte* not 
including checksum) 

9th and Bth 

Bytes* Storting absolute 

load address of 
bl oek ( 1 i ne) 


4th thru 

last bvte* Code or date to be 

1 oaded 

There is also an extra bvte of eheeksum. 


Refer fo figure 5-1. 
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9.2. 1.1 CO M D C ontent •_ 

The COMO hold* the following information to b# passed to the 
moni tori 

1, An Indication of whether t He modulo it load-time 
rel oeatabl a. 

2, The program's tranafap addpaaa. 

3, Tha lowest address loadad by the program (not In- 
cluding absolute coda), Undep.RSX, this address is 
tha lowaat addpaaa to ba used fop STACK space, 

4, Th$ size (In bvtaa) of tha program, UndaP R8X# 
this alia Includes the STACK epaee (Just below tha 
program) and tha real-time header (Just above tha 
program) . 

5, ODT'e tpanafar addraaa (0 If ODT not Included), 
Ignored under RSX, 

8, A .Hat of monitor routines raauirad to be loadad 
alone with the modulo (none under RSX) 

7, Tha load module name. 

8, The version identification 

The COMO apeears as binary data to ba loadad at tha lowest 
relocated address of tha program, Tha monitor loader will 
examine the. COMD. process It and eall tha proder routine to 
load tha program. 

The COMO consists of possibly several formatted binary 
lines, faeh line has a load address (ignored bv tha monitor 
loader) followed by sections of Information. Each section 
begins with an Identifying word indicating the type of aae- 
tion and the length of the aeetion as follows* 

Low Byte/HIgh Byte Meaning 


0 l 

1 / M 

2 / M 


End of COMd 

N words of general information 
follows, 

N monitor routine reauests 
fellow (0 under RSX) 
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Thus the COMD has on* op nor# iteHoni of general Informa- 
tion followed bv ona op wore sections of monitor routine re- 
quests followed bv a seetlon terminating the COMD. The ord- 
*p of the oanapal Information 1st 

WORD NUMBER CONTENTS 


1 Lowest addPeas leaded bv Program, 

2 Program size (in bvte*) this la the 
sum of th« alias of the relocatable 
sections. 

3 Program transfer address 

4 0DT*s transfer addraa* (0 If ODT 
not loaded) 

5 Raabaoluete 

laload time relocatable 

6*7 load module name. (2 words# . .RA058) 

10*11 lead module version Identification 

(2 words# .RADM0)., T h f 9 data la 
acou.irod from the version identifi- 
cation of the first object module 
1 Inked. 

The monitor routine requests are In the form of word* con- 
taining the routine'* number as aoeclfied In the monitor li- 
brary. 

Refer to fiour* 5-1. 
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8ij Obj jtet Hodul a Library Format 


Am ob 1 set . modul e library that exists as a formatted binary 
linked file Is a sequence of objeet modules ereeeded by a 
directory of the eontenta. 

A library is a useful file for three reasons! 

1. It saves havipa seoarats directory entries 1m a UFO 
for single object modules, 

2. It expedites the linking process. 

3. It allows for standardisation and controlled uodat- 
ino r of eommonly used routine, e.q. Fortran eoslne 
rout i na. 

The first dots byte of the first line of *n objeet module 
library contains the eode 7 to indicate the beginning of a 
library file. 

This line is followed by x lines of directory information 
termlneted by the end directory line (code 18), 

Now aopear the obieet modules In the same order as their en- 
tries In the directory, Refer to figures 9-6 and 9-7, 
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9.3.1 nireetorv Content* 


The directory eontaine ion* entry oer object module in the 
tame relative position aa ita aaaoclated object module. An 
entry la essentially the ob Jeet . mgdul *a GSO (refer to fig* 
urea 9*2 and 9*3) wlth^two additional reoul r*m*nta to allow 
for ontimum aearchlng of th* dlractorvi 

1. The GSD ea produced bv the assembler Is re-ordered 
so that all external .GLOBL'a appear after all th* 
•GLOBL entry polntaj that la* *11 the external 
•GLOBL'a which aopear with th* Absolute Program 
Section M*m* are moved to Just before the end GSD 
declaration In th* GSD. 

2. Lines mav eontain up to 93 deeimal data word*. If 

an. object module ha* no named .CSECT'a or .LOCAL'** 
thia buffer will allow for 20 decimal entry point* 

(80 word*) and 13 word* for 

GSO declaration (1) 

Objoet module name (4) 

Abaolute Program Section Nam* (4) 

Unnamed Relocatable Program Section Name (4) 

in th* first line. 


9.3.2 ObJect Module Cont ent* 


An ebieet module in an ob I eet ,modul * library 1* Identical to 
Its stand alone version (refer to aeetlon 9,11 exeaet that 
the GSD Is reduced to Ita first and last lines. Refer to 
figure 9-2. Th* first line contains the name of the objeet 
module for verification with jta directory entry and the 
last 1 i n* indicates th* end of th* GSD, 
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9 .4 Lo ud M od ul a Hbfirv Fo rmat (not vet imol emented) 


A load module library* that exists aa a formatted binary 
linked file, la a aeauenee of load nodules oreeeded by a di- 
rectory of the contents. 

The fir,st dpta byta of the first line of f load module 11* 
brary contains the eode 13 (octal) to Indicate the beolnnlnq 
of a load module library file. 

This line is followed by * lines of directory Information 
terminated by the end directory line (code 141. 

Now aDpear the load modules. In the same order as their en- 
tries in the directory. Refer to figures 9-0 and 9-9, 


9.4.1 Olfactory Conten t a 


The djreetory contains one entry ser load module in the same 
relative ooaition as its associated load module. An entry 
is the first line. of the load module (refer to figure 5-1) 
whleh la the first line of Its Communlestlons Directory 
(COMD) . 


9.4.2 Load Module _Confente 


A load module In a library is Identical to its stand alone 
version (refer to figure 5-1). 


faye T-*o 


G-SD 


R LD 


TXT 


f?LD 


TXT 


KLP 


Global Sy**»kfcl Diffctoy 

f?c locate n Directory 
(^kt first ©**■ feyoifed) 


Text Slock* 


Relocation Di’recior 


7 


7 ck+ Block 0 


Relocation Director 


7 


TXT 


Rlp 


ISP 


MOPUtF 

BRP 


Text" Block * 


Relocation Director 


7 


Interna \ SymUl Directory 

( fldt yet , 


Figure T- 1 


ObjCc't' /Module. Format' 
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HOW TO OBTAIN SOFTWARE INFORMATION 


Announcements for new and revised software, as well as programming notes, 
software problems, and documentation corrections are published by Software 
Information Service in the following newsletters. 

Digital Software News for the PDP-8 & PDP-12 
Digital Software News for the PDP-11 
Digital Software News for the PDP-9/15 Family 

These newsletters contain information applicable to software available from 
Digital's Program Library, Articles in Digital Software News update the 
cumulative Software Performance Summary which is contained in each basic 
kit of system software for new computers. To assure that the monthly Digital 
Software News is sent to the appropriate software contact at your installation, 
please check with the Software Specialist or Sales Engineer at your nearest 
Digital office. 

Questions or problems concerning Digital's Software should be reported to 
the Software Specialist. In cases where no Software Specialist is available, 
please send a Software Performance Report form with details of the problem to: 

Software Information Service 
Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 

These forms which are provided in the software kit should be fully filled out 
and accompanied by teletype output as well as listings or tapes of the user 
program to facilitate a complete investigation. An answer will be sent to the 
individual and appropriate topics of general interest will be printed in the 
newsletter. 

Orders for new and revised software and manuals, additional Software Per- 
formance Report forms, and software price lists should be directed to the 
nearest Digital Field office or representative. U.S.A. customers may order 
directly from the Prc^nm Library in Maynard. When ordering, include the 
code number and a brief description of the software requested. 

Digital Equipment Computer Users Society (DECUS) maintains a user library 
and publishes a catalog of programs as well as the DECUSCOPE magazine 
for its members and non-members who request it. For further information 
please write to: 


DECUS 

Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 
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READER'S COMMENTS 


Digital Equipment Corporation maintains a continuous effort to improve the quality and usefulness 
of its publications. To do this effectively we need user feedback — your critical evaluation of 
this manual . 

Please comment on this manual's completeness, accuracy, organization, usability and read- 
ability. 


Did you find errors in this manual? If so, specify by page. 


How can this manual be improved? 


Other comments? 


Please state your position. 
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State: 
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